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ABSTRACT 


The automation of software development has long been a goal of software 
engineering to increase efficiency of the development effort and improve the software 
product. This efficiency (high productivity with less software faults) results from best 
practices in building, managing and testing software projects via the use of these 
automated tools and processes. However, each software development tool has its own 
characteristics, semantics, objects, and concepts. While there have been significant 
results achieved by use of automated software development tools (coming mainly from 
the widespread increase of customers’ adoption of these tools), there remains many 
challenging obstacles: lack of communication between the different software 
development tools, poor shared understanding; use of different syntax and concepts 
between tools, limits in interoperability between tools, absence of a unifying conceptual 
models and ideas between tools, and redundant work and cross purposes between tools. 

The approach undertaken in this thesis to overcome these obstacles was to 
construct a “pilot” ontology that is extensible. We applied the Feature-Oriented Domain 
Analysis Approach to capture the commonalities between two software development 
tools (Rational Software Corporation's RequisitePro, a main-stream, complex, 
commercial tool), and a software prototyping tool (the Software Engineering Automation 
tool (SEATools), a research model with tool support for developing executable software 
prototypes) and developed an ontology for the software development tools using the 
Protégé-2000 system. The ontology, expressed in UML, promotes interoperability and 


enhanced communication. 
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I. INTRODUCTION 


A. MOTIVATION AND PURPOSE OF THE RESEARCH EFFORT 

The automation of software development has long been a goal of software 
engineering to increase efficiency of the development effort and improve the software 
product. This efficiency (high productivity with less software faults) results from best 
practices in building, managing and testing software projects via the use of these 
automated tools and processes. However, each software development tool has its own 
characteristics, semantics, objects, and concepts. While there have been significant 
results achieved by use of automated software development tools (coming mainly from 
the widespread increase of customers’ adoption rate of these tools), there remains many 


challenging obstacles: 


e Lack of communication between the different software development tool, 

e Poor shared understanding; use of different syntax and concepts between 
tool, 

e Limit of interoperability between tools, 

e Absence of a unifying conceptual models and ideas between tools, 

e Redundant work and cross purposes between tools. 


These obstacles stem from different contexts, understandings, viewpoints and 


assumptions that lead to wasted effort. 


One way to overcome some of these obstacles is to establish a unifying contextual 
framework for different software engineering tools -- an “ontology” which will unify the 
different concepts and ideas in the domain. As such an ontology emerges; people, 
organizations, and software systems will communicate with more efficiency. Creating an 
ontology actually means determining the set of semantic categories which properly 
reflect the particular conceptual organization of the domain of information, on which the 
system must operate, thus optimizing the res ults (quantitatively and qualitatively) of the 


shared information. 


Recently, Young proposed an object-oriented methodology for establishing 


interoperability between heterogeneous systems [YOUNO2] that allows interaction 
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between their different objects. This approach is ideal for resolving the differences 
existing between different kinds of systems via an establishment of a high level 
interoperability model (Federation Interoperability Object Model (FIOM)). The 
establishment of such object federation between existing process models together with 
the integration of the federation with an extended evolution model, will generate an 


availability of inputs and outputs between subordinate models to each other. 


The purpose of this research is to begin an investigation to address the problems 
mentioned previously by identifying and defining the essential characteristics of two 
software engineering tools: a Requirement's Engineering Tool (Rational Software 
Corporation's Requisite®Pro, a main-stream, complex, commercial tool), and a software 
prototyping tool (the Software Engineering Automation tool (SEATools), a research 
model with tool support for developing executable software prototypes). The approach 
undertaken was to construct a “pilot” ontology that might be extended in the future to 
include other software development tools. The essential idea was to capture the 
commonalities between these two tools and express them in such a way that would 
promote interoperability and enhanced communication using Young’s interoperability 


model. 


The approach in this portion of the investigation was first to analyze the structure, 
inputs, and outputs of the two individual tools, perform a domain analysis (of this subset 
of tools) and produce a feature model of that domain. We then used the feature model to 
identify the characteristics of each individual software development tool that must be 
accounted for within a higher-level ontology. Finally, we sought to build an ontology 
capable of providing a common view of the domain, providing an effective representation 
of relations (similarities and differences, interacting via compatible translation, 
transformations) between representations of corresponding concepts in the different 
software development tools. This was especially important since the corresponding 


concepts of the two tools are not exactly the same, but contain subtle differences. 


B. STATEMENT OF THE RESEARCH QUESTION 
The research question for this thesis is as follows: 


e What is an appropriate methodology for developing a Software 
Development Tool Ontology for establishing interoperability between 
software development tools? 


Note that this research question implies that the methodology used to arrive at the 
ontology is as important as the ontology itself. While the ontology will determine 
whether the interoperability ontology for the two software development tools (Rational 
RequisitePro and Software Engineering Automation tools (SEATools)) is appropriate, the 
methodology will also ensure that the ontology can be later extended with the inclusion 


of additional tools. 


Before building this ontology, our study will focus on investigating the essential 
characteristics of these two software development tools, then building a feature model 
representing the essential identified characteristics (extracted from the user manuals and 
the use of the tool itself) for each tool. Finally, we distinguish the commonalities 
between the two tools to build a high level ontology unifying the framework of 


interoperability and translation of the two tools. 


Ontology literature is full of examples of the development of ontologies in several 
different domains. While software development tools is not one of these domains, the 
experiences of these previous researchers (and the methodologies they used to develop 
their ontologies) provide a starting place for the development of a methodology that we 


can use to develop a software development tool ontology. 


C. CONTRIBUTIONS 


Developing software engineering design environments that maximize 
interoperability, communication and efficiency tailored for particular domains is a 
common objective for software engineering stakeholders who seek to improve the 
outputs by automating engineering practice around a specific domain. The larger 
software development community has embraced the concepts of Product Lines and 


Generative Programming techniques. The advantage of developing specific ontologies 
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tailored to the domain of the engineering enterprise provides benefits stemming from 
representational efficiency. However, there has not been a lot of work in developing 
ontologies tailored to the domain of software development itself. One reason for this is 
the amount of effort required to produce such an ontology is substantial. Specific 
ontologies such as this ongoing project are, in fact, not easily buildable, which obliges us 
to undertake seemingly heavy processes to identify existing features in both software 
engineering tools to satisfy the representational needs. An ideal solution will be offered 
by the cons truction of a general ontology for common features management, which might 
allow for resource sharing and artifact porting over and across multiple tools in the 
software engineering domain, possibly with an easy and fast process of customization 


without having to develop new systems from scratch [LENCO01]. 


The software engineering contributions represented in this thesis are: 


e An initial investigation and analysis of the structure, inputs, and outputs of 
the two individual software development tools, and the identification of 
essential characteristics of these tools. 


e The completion of a domain analysis (of this subset of tools) and 
production of a feature model for each tool’s characteristics. 


° An identification of the commonalities between the two software to ols’ 
characteristics that must be accounted for in building a high level ontology 
for the domain. 


e The construction of an initial high-level ontology using a knowledge- 
based design and knowledge system developed at Stanford University: 
“Protégé 2000”. 

e The establishment of a methodology around which future software 


development tools can be analyzed and added to this initial software 
development tool ontology. 


Ontologies can serve many purposes associated with communication, 
interoperability, and systems engineering functions (reusability, specification, etc.) 
[USCH96]. The ontology that was generated in this research was influenced by the 
future goal and intended use of the ontology. In this case, the intended use was to 
establish interoperability between tw o software development tools. These tools were not 
chosen arbitrarily. The future purpose of the ontology biases the choice of the particular 


set of features that are analyzed. The future purpose biases the organization of the 
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domain of interest by highlighting commonalities and resemblances needed for the given 
purpose. For instance, because we started by analyzing the requirement management tool 
followed by the computer aided prototyping tool in order to come up with the essential 
characteristics that make them interoperate, it is not surprising that the ontology tailored 
to this goal appears to be more requirement management oriented than say, “software 
testing” oriented. Conversely, the design of a general ontology (applicable to all software 
engineering tools), while lacking the important guidance represented by application - 
driven and tool-driven constraints, must regard the versatility of the template or 


framework as one of the most important promising achievements [LENCO1]. 


Our strategy for developing the ontology was based on both a top-down and 
bottom-up approach. In order to be effective, we sought to make the top-down approach 
tackle the core problem of the interoperability between the software development tools 
[SOWAO00]. The bottom-up approach, focused on developing specific tool ontologies 
that accurately described the artifacts produced by the tools so that their data processes 
could be actually made to interoperate. A software development tool ontology is a 
system of features, selected because of their usefulness to capture interesting 
commonalities and similarities between tools. The choice of a proper ontology for the 
software development tools was a very important factor in accomplishing the task of 
interoperability building and struc turing, far beyond the issue of the representation of the 


inventory of the software development tools’ features. 


D. INTRODUCTION TO ONTOLOGIES 

The history of the word “ontology” first appeared in philosophy referring to the 
subject of “existence”. The same word also shares some commonalities with the 
“epistemology”, which is about knowledge and knowing. These latter commonalities are 
particularly obvious in the context of knowledge sharing, where an ontology is a 
description (similar to a formal specification of a program) of the concepts and 
relationships that can exist for an entity or a group of entities [GRUBO2]. Corazzon in 
his article “descriptive and formal ontology” defines an Ontology as a theory of objects 


and their relationships [CORA02]. The widespread use of ontologies provides a 
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meaningful practice for distinguishing various types of objects (concrete and abstract, 
existent and non-existent, real and ideal, independent and dependent) and their ties 


(relations, dependences and predication). 


Modern usage of ontology is influenced by a commingled theory developed from 
both philosophers and scientists working in Artificial Intelligence, database theory and 
natural language processing. [CORAO2] introduces the possibility of distinguishing 
ontology as “conceptual analysis” from ontology as “technology.” Descriptive and 
Formal Ontologies present contemporary developments in ontology in both the 
philosophical and the technological contexts. This latter kind of ontology will be the 
basis of our approach, especially in trying to develop an ontology allowing 


interoperability and communication between different software development tools. 


Lenci defines ontologies as a core ingredient in knowledge management and 
content-based systems [LENCO1]. Ontologies’ tasks start from document search and 
categorization to information extraction and text mining. Ontologies also represent an 
important bridge between knowledge representation and computational lexical semantics. 
Ontologies are widely used as formal devices to represent the lexical content of words, 
and appear to have a crucial role in different language engineering (LE) tasks, such as 


content-based tagging, word sense disambiguation, multilingual transfer, etc. [LENCO1]. 


Lenci illustrates the example of a top-down ontology, aiming at a universal 
coverage of human categories. For instance, Cyc [LENA90] forms a huge knowledge 
base containing over 100,000 concept types in the domain of universal coverage of 
human categories. The example demonstrates the potential advantage of general 
ontologies in that they can represent a common language for systems dealing with 


knowledge representation in different domains [LENCO1]. 
Sowa [SOWAO0], as quoted by [LENCO1], defines an ontology as: 


a catalogue of the type of things that are assumed to exist in a domain of 
interest D, from the perspective of a person who uses a language L for the 
purpose of talking about D. 


Furthermore, Lenci emphases the fact that an ontology must include only 
instances that belong to the same domain of interest [LENCO1]: 
From a semantic point of view, an ontology determines the domain of 
discourse for a language L, i.e. what L talks about. The ontology on which 
L is interpreted actually constrains the expressiveness of L itself. For 
instance, if the ontology only contains plants and animals, then it will be 
impossible to speak about computers, unless they are categorized either as 
plants or as animals, thereby losing the possibility to account for crucial 


differences among them. To be able to do this, the ontology should be 
refined by adding a further category, e.g. the one of artifactual objects. 


It can be inferred from the previous quote that “Artifact” is an ambiguous term 
that can be confusing because it masks a number of unstated assumptions. “Artifact” can 
be used to mean a physical object, a primary record, or a physical object that constitutes a 
primary record. From the point of view of a researcher, and for the purposes of 
developing an interoperability ontology or any other kind of ontology, an artifact can be 
defined as an information resource in which the information is recorded on a physical 
medium belonging to a certain domain of interest (such as animals and plants), which 
may or may not be unique, and in which the type adheres not only in the domain of 
interest, but also in the object itself. In other words, artifacts are things that have intrinsic 


value, independent of the informational content [LENCO01]. 


Another view of ontologies [USCH96] defines “Ontology” as a term used to refer 
to the shared understanding of some domain of interest. This domain of interest may be 
used for the purpose of unifying certain frameworks to solve particular problems in the 
same domain. Regardless of the domain of exploration, an ontology should necessarily 
include some sort of world view conceived as a set of concepts (such as entities, 
relations, and attributes from one side and their definitions and inter -relationships from 
another side) with respect to a given domain. Moreover, because people, organizations, 
and software systems need to communicate between and among themselves for more 
efficiency, there are often difficulties/inaccuracies in communications generated from 
differing contexts, understandings, viewpoints and assumptions. One way to solve this 


troublesome behavior is by building ontologies that help by: 


e Improving poor communication, 


e Establishing a unified environment for conceptual models and ideas, 
e Preventing redundant work and cross purposes, 

e Increasing productivity via the ease of understandability, 

e Providing a widespread use of the domain of interest. 


Ontologies are an efficient way to reduce or eliminate conceptual and semantic 


confusion. They establish a shared understanding and unifying framework. These latter 


have as a main objective the improvements of: 


e Communication between people with different backgrounds, needs and 
viewpoints arising from different contexts. Examples may include: 


Normative Models: that establishes the semantics of the system 
and potential extensions, 


Networks of Relationships: which explore the relationships 
between different entities, 


Consistency and Ambiguity: by providing unambiguous and clear 
definitions, 


Integration of different User Perspectives: by establishing a 
groundwork for development of standards within the community. 


e Interoperability among systems achieved by translating between different 
modeling methods, paradigms, languages, and software tools. Examples 
may include: 


Integrating environments for tools, 


Inter-lingua Translators: assures a meaningful understanding of a 
domain given in different languages, 


Internal Interoperability: integration of different systems, 


External Interoperability: assures an openness of organizations to 
the outside world, 


Integrating Ontologies: integrates Domains and Tools. 


e System engineering ontologies (such as reliability engineering, reuse 
engineering) may improve: 


Specification: shared understanding assists in establishing the 
specifications of systems, 


Reliability: can form the basis for manual checking. Formal 
ontologies can be used to make assumptions explicit to users. 


e Reusability: allows modules to be imported and exported between 
systems. 


Gruber states that the basis of representing knowledge formally accounts in great 
part on conceptualization (an abstract, simplified view of the domain of interest to be 
represented): the objects, concepts, and other entities that are assumed to exist in a 
domain of interest as well as the relationships that exist among them [GRUBO2]. Every 
knowledge base, whether it is a knowledge-based system or knowledge-level agent, is 
committed to some explicit or implicit conceptualization. This approach is important in 
our case of developing an ontology for software development tools, where we simplify 
the view of software development tools represented as well as depict the eventual 


relationships that exist among them. 


The development of ontologies is not a new concept. Various work on ontologies 
has emerged in different domains of interest. We have introduced about fiv e different 
views of what ontologies are depending on the domain of interest. However, their 
common denominator is mainly characterized by defining the vocabulary with which 
queries and assertions are exchanged among entities. These describe ontological 
commitments (Ontological commitments are agreements to use the shared vocabulary in 
a coherent and consistent manner) that enable different entities operating on different 
theories to communicate about a domain of interest. All of this provides a foundation for 
our work. Our objective was to develop an ontology characterized by a certain kind of 
formalism, allowing interoperability between different tools within the same domain of 
interest, and capable of increasing the degree to which different software development 


tools communicate with each other. 


The entities sharing a vocabulary do not necessarily have the same knowledge 
base; we may consider an entity that knows things and other entity that does not. An 
entity that commits to an ontology is not required to answer all queries that can be 
formulated in the shared vocabulary. In short, a commitment to a common ontology is a 
guarantee of consistency, but not completeness, with respect to queries and assertions 


using the vocabulary defined in the ontology 


E. SUMMARY 

The objective for building this ontology is to offer a powerful and versatile tool 
for the representation of the commonalities between essential features of two software 
engineering tools (Rationale RequisitePro and the Software Engineering Automation 
Tools (SEATools)). This represents several challenges for the ontology design, since it 
requires tackling the difficult issue of providing an explicit and adequate technical 
behavior of each feature, a crucial condition for them to be properly usable as the main 


backbone in the interoperability between different tools [LENCO1]. 


Fortunately, we ended up by overcoming these challenges and developed an 
ontology that can be used for interoperabity between two software development tools and 
serving as a pilot that can be extended to include more software development tools. More 
importantly, we developed a methodology, which can be used to add and analyze 


additional tools to this ontology framework. 
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Il. FOUNDATION AND RELATED WORK 


A. INTRODUCTION 

Several other researchers’ works form the foundation to this research and others 
are related or (competing) work. The foundation work is full of examples dealing with 
interoperability and communication of heterogeneous systems. While software 
development tools is not one of these domains, the experiences of these previous 
researchers provide a starting place for the development of a methodology that we can 


use to develop a software development tool ontology. 


B. FOUNDATION WORK 

There are several works that deal in some way with the interoperability and 
communication of heterogeneous systems that provide a motivation and foundation for 
our research. These works preceded ours and constitute the basis for our software 
development tools’ ontology. Among these works we select the following according to 
the degree to which they together with ours compliment each other and contribute to the 
enrichment of software engineering. 


1. Software Tool Interoperability [PUET02, 03] 
a. Summary 


Puett proposed an initial investigation into the development of a Holistic 
Framework for Software Engineering (HFSE) [PUETO02, 03]. This Holistic Framework 
establishes mechanisms by which existing software development tools and models 
interoperate. He presents the holistic framework as an efficient way to provide seamless 
interoperability between software tools and models with improvement to both process 
and product. The HFSE captures and uses dependency relationships among 
heterogeneous software develo pment artifacts, the results of w hich are used by software 
engineers to improve software processes and product integrity. This kind of framework 
triggers the research for discovering dependencies among different aspects of the 
software engineering process. In the meantime, an implementation of processes 


enhancing the software integrity is likely to be achieved. This latter is one of the many 
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improvements expected from establishing an HFSE. A second advantage would be to 
automate the software development process as long as models or too Is, inputs and outputs 
can be supplied through the holistic model. Different tools will be able to interact 
automatically, with less involvement of the software engineer. Because all artifacts 
within the holistic model are tracked together as a large dependency graph, it is possible 
to extract select “slices” of the dependency graph for particular purposes, allowing more 
“focused” development. For example, since the holistic model interacts with existing 
process models such as software risk, reuse, and testing; it will then be possible to extract 
a “‘slice” of the entire dependency graph (a slice that represents the greatest risk) so that 
prototyping and analysis effort is not wasted on developing artifacts that are already well 
defined, understood, and/or successfully implemented in previous versions. 

b. Concepts Useful to the Thesis 

One of the mechanisms that is required by the HFSE is the development of 
an ontology via which existing software development tools will interoperate. 
Characterizing different software development tools, and capturing the different 
commonalities between them to be later assembled in a kind of dictionary will be the 
crucial part of this approach. This contribution will improve the communication between 
the different parts of the software development process and the software development 
tools themselves. The ontology for software development tools constitutes the first step 
allowing the HFSE to capture and use dependency relationships among heterogeneous 
software development atifacts. This ontology will be used as unifying framework for 
improving communication and translating between the software development tools. The 
ontology will form the basis for the establishment of Component and Federation 
representations of the artifacts and activities of software development processes. 

2. Software Evolution [HARN99c] 

a. Summary 

Harn, in his PhD dissertation [HARN99c], describes software evolution in 
terms of a Relational Hypergraph model (RH model). His work extends the work of 
several others [LUQI90] [BADR93] [IBRA96] who established the use of directed 
graphs and hypergraphs for managing the complexities of software evolution. Harn's 


model establishes dependencies and links between key activities and artifacts of a 
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particular software development model and also between sequential iterations of cycles 
within that model. Furthermore, the model plays a significant role in allowing the 
management of both the activities in a software development project and the artifacts 
produced by these activities using automated tools devoted to this purpose. As an 
illustration of such a tool, the Computer Aided Software Evolution System (CASES) was 


developed at the Naval Postgraduate School in support of Harn's work. 


CASES is a software tool that performs the following functions during 
software evolution: control, management, formation, refinement, traceability, and 
assignment. It manages and controls all the activities that affect a software system and 
the relationships among these activities by changing them. CASES is based on the 


relationships of the Software Evolution Process Model as shown in detail in Figure 1. 
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Figure 1. Software Evolution Processes with CASES [HARN99c]. 


In the relational hypergraph, software evolution objects are activities and 
artifacts affected by the software evolution process. They consist of “Steps” and 
“Components.” The relational hypergraph links these objects and establish dependencies 


between the objects via the use of a hierarchical refinement. Harn's work forms the basis 
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for establishing a Software Evolution Model which forms as the core for the Holistic 
Framework for Software Engineering. 
b. Concepts Useful to the Thesis 
By adding extensions, the Relational Hypergraph becomes a very useful 
mathematical construct for establishing dependencies between evolution artifacts and 
forms a foundation for establishing interoperability and dependency tracking between 
such artifacts. However, before such constructs can be developed, the artifacts and 
activities (and their associated properties) must be identified and defined. An appropriate 
means of capturing these artifacts and activities is through the use of an ontology. 
Constructs within CASES can then be developed that allow the software designer to 
“build” the objects, components, steps, and attributes that the designer uses. The 
development of an ontology that unifies all the terms and improves the communicational 
environment of software development must also be extensible to account for unforeseen 
constructs. 
3. Object-Oriented Model for Interoperability (QOMD[YOUN02] 
a. Summary 
Young's Object-Oriented Model for Interoperability [YOUNO2] relies on 
Object-Oriented Analysis and Design (OOAD) to establish a federation of objects for 
interoperability between heterogeneous systems. Young points out that consistent 
representation of the same real world entity in various legacy software products is a 
continual problem for system interoperability. To address this problem, he presents an 
Object-Oriented Model for Interoperability (OOMI). This model is used to solve the data 
and operation consistency problems in legacy systems. The model calls for the 
establishment of a Federation Interoperability Object Model (FIOM) that is specified for 
a specific group of systems (termed a “federation’’) designated for interoperation. Young 
states [YOUNGO1]: 
The FIOM consists of a number of Federation Entities (FEs) that contain 
the data and operations to be shared between systems. The FIOM also 


captures the translations required to resolve differences in representation 
of this data and operations. 
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An example UML representation of an FIOM is shown in Figure 2 below: 


FederationEntityA. FederationEntityB 
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Figure 2. Federation Interoperability Object Model [YOUNO2]. 


At runtime, the OOMI uses a middleware-based translator to process the 
information contained in the FIOM. The translator automatically converts instances of 
real-world entity attributes and operations to the proper representation to enable 


interoperation between systems (see Figure 3 below): 
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Figure 3. Middleware Translator Implementation [YOUNO2]. 


In addition to defining the constructs of the OOMI, Young provides a 


specialized toolset used to create the FIOM prior to run-time. This tool set is called the 


Object Oriented Model for Interoperability Integrated Development Environment (OOMI 
IDE) and is used to: 


Discover the information and operations shared between federation 
components, 


Provide assistance in identifying the different representations used for 
such information and operations by component systems, 


Define the transformations required to translate between different 
representations, and 


Generate system-specific information used to resolve representational 
differences between component systems. 


b. Concepts Useful to the Thesis 


Young's OOMI provides a mechanism for establishing the interoperability 


of various software development tools and models. The only requirement for these tools 


and models is that they be definable within an object paradigm [PUETO2]: 
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e Young identifies two concepts that will be directly applicable to mapping 
multiple software engineering tools to each other within the HFSE: 
heterogeneity of scope and heterogeneity of representation. Heterogeneity 
of scope refers to the fact that differing amounts and types of information 
can be specified by different systems to represent the state and behavior of 
the same entity. Heterogeneity of representation refers to the fact that 
different systems, when referring to the same entity, often have differences 
in: terminology used, format, accuracy, range of values allowed, and 
structural representation of the included state and behavioral information. 


e Several of the challenges facing the HFSE will be how to resolve different 
levels of abstraction for information provided in different tools and 
models. The Federation Entity View (FEV) in Young's OOMI may 
provide the ability to resolve these differences [Young02]: 


The FEV contains the translations required to convert between each 
component system representation and the 'standard' representation of that 
view. ‘These translations are used to resolve differences in physical 
representation, accuracy tolerances, range of values allowed, and 
terminology used in representing a federation entity view. These 
translations are defined by the interoperability engineer and stored in the 
FEV for subsequent use. 

A start towards tackling these challenges is via the use of an ontology 
capable of capturing the commonalities between different software development tools. 
This ontology will be used as a unifying framework for improving communication and 
translating between software development tools. The ontology will form the basis for the 
establishment of Component and Federation Representations of the artifacts and activities 
of software development processes. 

4. Ontologies: Principles, Methods and Applications [USCH96] 

a. Summary 

Uschold and Grainger define “Ontology” as a term used to refer to the 
shared understanding of some domain of interest [USCH96]. This domain of interest 
may be used to solve particular problems in that domain. An ontology should necessarily 
include some sort of world view conceived as a set of concepts. One powerful way to 
solve the troublesome behavior of communication difficulties/inaccuracies is by building 
ontologies that would: 

e Establish a unified environment for conceptual models and ideas, 


e Prevent redundant work and cross purposes, 
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e Provide a widespread use of the domain of interest. 
Ontologies are an efficient way to reduce or eliminate conceptual and 
terminology confusion. They establish a shared understanding and unifying framework. 
They improve: 


e Communication between people with different backgrounds, needs and 
viewpoints arising from different contexts, 


e Interoperability among systems achieved by translating between different 
modeling methods, paradigms, languages, and software tools. 


As an example of an ontology, the Enterprise Ontology [USCH98] was 
developed within the Enterprise Project, a collaborative effort (by the Artificial 
Intelligence Applications Institute at the University of Edinburgh with its partners: IBM, 
Lloyd's Register, Logica UK Limited, and Unilever) to provide a framework for 
enterprise business modeling. The ontology was built to serve as a basis for this 
framework, which includes methods and a computer tool set for enterprise modeling. 
This ontology is presented as a collection of terms and definitions relevant to business 
enterprises. The authors present natural language definitions for all the terms, starting 
with the foundational concepts used to define the main body of terms such as entity, 
relationship, and actor. As an example of an ontology, Table 1 is a complete list of the 
terms defined in the Enterprise Ontology. The table shows a collection of terms and 
definitions relevant to business enterprises. This collection is presented in natural 
language and classifies the terms by categories, starting from activities and process all the 


way through time. 
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Major Category Ontology Terms 


Activity Activity Specification, Execute, Executed Activity 
Specification, T-Begin, T-End, Pre-Conditions, Effect, Doer, 
Sub-Activity, Authority, Activity Owner, Event, Plan, Sub- 
Plan, Planning, Process Specification, Capability, Skill, 
Resource, Resource Allocation, Resource Substitute. 
Organization Person, Machine, Corporation, Partnership, Partner, Legal 
Entity, Organizational Unit, Manage, Delegate, Management 
Link, Legal Ownership, Non-Legal Ownership, Ownership, 
Owner, Asset, Stakeholder, Employment Contract, Share, 
Share Holder. 


Strategy Purpose, Hold Purpose, Intended Purpose, Strategic Purpose, 
Objective, vision, Mission, Goal, Help Achieve, Strategy, 
Strategic Planning, Strategic Action, Decision, Assumption, 
Critical Assumption, Non-Critical Assumption, Influence 
Factor, Critical Influence Factor, Non-Critical Influence 
Factor, Critical Success Factor, Risk. 


Marketing Sale, Potential Sale, For Sale, Sale Offer, Vendor, Actual 


Customer, Potential Customer, Customer, Reseller, Product, 
Asking Price, Sale Price, Market, Segmentation Variable, 
Market Segment, Market Research, Brand Image, Feature, 
Need, Market Need, Promotion, Competitor. 


Time Line, Time Interval, Time Point. 


Table 1. List of the Terms Defined in the Enterprise Ontology [ENTRO2]. 





The idea of the Enterprise Ontology was extended by The Enterprise Tool 
Set (consisting of various components each serving one or more main purposes) designed 
to facilitate the integration of multiple independently developed software tools in a single 


package (Figure 4). To an end user running an application, there is no visible distinction 
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between a function being achieved by a module in the Tool Set itself or by an outside 


tool. 


Tool Set 
Administration 









Procedure 
Builder 
Method Expert 


Figure 4. Tool Set Architecture [USCH98]. 


Figure 4 illustrates the flexible agent-based architecture of the enterprise 
tool set us ed to achieve tool integration. 

b. Concepts Useful to the Thesis 

[USCH96] is useful because it defines what an ontology is, the usage of 
domain of interest and the possibility of using it for the purpose of unifying certain 
frameworks to solve particular problems in the same domain. The authors discuss the 
uses of ontologies, and present an initial methodology to build an ontology - a 
methodology that we adopted and modified to suit our purposes. This article served as 
guidance in including the concepts collected or identified from the analysis of some 
software development tools in our ontology. This necessity was fulfilled by including 
concepts such as: entities, relations, and attributes and their definitions and inter - 
relationships. Furthermore, the use of the Enterprise Ontology is an example for the 
representation of the software development tool ontology. The conceptual analysis for 
this ontology is applicable for reuse with software development tools, avoiding the need 
to start from scratch and build yet another special purpose process-modeling language. 


This results in: 
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e Savings due to reuse, 


e Savings in initial coding time, 
° More responsive to change due to the increased modularity of the Tool Set 
software. 


Note that these three savings will be barely felt in the case of our software 
development tools ontology (the first pilot work), but would be achievable in case of 
extending it, building other ontologies, or reusing this one. 

5. UML as an Ontology Description Language [CRANO1] 

a. Summary 

Cranefield, et. al. presents the Unified Modeling Language as a_ possible 
language for defining and describing domain ontologies [CRANOI]. They also view 
ontologies as having an important role in defining the terminology that agents use in the 
exchange of know ledge-level messages. As object-oriented modeling, and the Unified 
Modeling Language (UML) in particular, have built up a huge following in the field of 
software engineering and are widely supported by robust commercial tools, the use of 
UML for ontology representation in agent systems would help to hasten the uptake of 
agent-based systems concepts into industry. The use of UML is almost generalized in 
industry, therefore it provides an effective and scalable approach to conceptual modeling, 
and thus it should be seriously considered as an ontology modeling language. The paper 
also examines the potential for UML to be used for ontology modeling, compares it to 
traditional description logic formalisms and discusses some further possibilities for 
applying UML-based technologies to agent communication systems. The authors added 
that according to their point of view, UML could be regarded as a suitable candidate for 
knowledge representation. 

b. Concepts Useful to the Thesis 

Since our ontology is mainly developed to catch the commonalities 
between the different artifacts associated with different software development tools, 
serving as a dictionary allowing communication and interoperability between these tools, 
we choose the usage of a widespread adopted langua ge: the Unified Modeling Language 
(UML). The use of UML for our ontology representation helps to show the inter - 


relationships between classes using relationships between classes and inheritance. 
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Moreover, the second reason behind our choice of using UML in depicting the inter- 
relationships between the different artifacts present in our software development tool 
ontology, resulted from the use of the Protégé software ontology capture tool. Protégé 
also uses relationships and inheritances in showing inter -relationships between classes of 
the software development tools parts of the ontology. Thus, it is convenient for us to 
show the relationship between classes of different ontologies using UML. Previously, we 
presented Object-Oriented Model for Interoperability (OOMI) [YOUNO2]. OOMI 
methodology uses a UML type structure to express the inter -relationships between 
objects in different ontologies — we want to mirror that implementation. Our work 
together with Object-Oriented Model for Interoperability (OQOMI) are related to each 
other and complement each other; this fact was also taken into account when choosing to 
use UML. 
6. Overview of Protégé [PROT02] 


a. Summary 

Protégé-2000 is a knowledge-based design and knowledge-acquisition 
system developed over more than a decade at Stanford University as a software 
engineering methodology [MUSE95a]. It is available free under the open-source Mozilla 
Public License and is compatible with a wide range of knowledge representation 
languages [PROT02]. The tool allows the designer to create custom knowledge-based 
tools for whatever application is needed. Protégé assists software developers in creating 
and maintaining explicit domain models, and in incorporating those models directly into 
program code. Protégé allows system builders to construct software systems from 
modular components, including: 

e Reusable frameworks for assembling domain models, 


e Reusable domain-independent problem-methods that implement 
procedural strategies for solving tasks [ERIK95]. Protégé allows r euse of 
frameworks for building domain models through its support for 
declarative domain ontologies. 


The core concept behind the architectural makeup of Protégé-2000 is the 
design of an ontology or the set of concepts and their relations. This allows for 


granularity in a domain-specific area, which allows domain experts to use the tool to 
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establish a knowledge base. Using a problem-solving methods specific to that domain, 


domain experts can then search this knowledge base. 


The Protégé-2000 knowledge model has four main concepts that are 


represented in the software by frames: 


° Classes, 

° Instances, 
° Slots, 

° Facets. 


The tool uses “classes” and “instances” distinctly and employs a third type 
of modeling abstraction called “slots”. Classes represent the definitions of concepts, 
instances represent the specific examples of a concept, slots represent attributes of either 
a class or an instance. Finally there are facets, which are defined as properties of slots, 


and are constraints on, slot values [PROTO2]. 
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Figure 5 was taken from the RequisitePro Ontology as an illustration 
showing the different slots, cardinalities, instances, and queries allowed by the Protégé 
Tool. 
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Figure 6. Classes and Related Slots. 


Figure 6 shows the different artifacts (classes, slots, facets...) of the 
Protégé tool as well as the interface allowing the manipulation of the information used in 
building the ontology. The classes are in the left side of the screen shot and slots on the 


right. 


The Protégé approach is quite different from that taken in traditional 
object-oriented programming, where both the domain knowledge (slots of objects and the 
values associated with particular slots) and the problem solvers (methods associated with 
specific objects) are bundled together. In traditional object-oriented programming, 
program execution is controlled by sending messages from one object to another, where 
each object encapsulates both data and the methods that operate on th ose data [BOOC94]. 
In the Protégé approach, however, the problem-solving methods are first-class entities 


that have formal parameters that must be mapped to the appropriate referents in the 
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domain knowledge. The separation of problem-solving methods from the domain 
knowledge on which those methods operate is essential for component reuse. The 
language for expressing ontologies in Protégé is a frame-based representation system in 
which classes have slots of defined cardinality and data type. Slots may have data that 
represent instances of other classes in the ontology (e.g., when a class called 
“prescription” has a slot called “drug-prescribed” that takes on as values instances of 
another class “drug”). When the data type of a slot is an instance, the on tology-definition 
language allows the developer to set explicit constraints on the classes whose instances 
are allowed as values for that slot. When the data type of a slot is a string, the language 
allows the user optionally to specify a grammar that res tricts the kinds of strings that may 
be used as values for that slot [MUSE98]. 


Facets are defined as properties of slots. Multi-inheritance is allowed 
between classes and every instance of a class is an instance of the superclass of that class. 
Classes can also be instances of other classes. The Protégé-2000 environment is divided 
into tabs. Each tab is divided into panes. The plug-in architecture of Protégé-2000 
makes possible a number of specialized visual tools for entering guideline knowledge 
[OVERO2]. The tool itself is GUI-based so all the design is done using forms and tabs. 
The interface is easy-to-use due to the placement of widgets and tabs that give the 
designer easy access to the tools. The tool also employs a visualization tool that allo ws 


the designer to see and editor the ontology structure. 


As a conclusion, Protégé-2000 gives the user the ability to construct a 
domain ontology by using a robust knowledge model. The model uses domain -expert 
knowledge to design a tool that can be accessed by other applications to tap into its 
knowledge base. 

b. Concepts Useful to the Thesis 

Protégé was originally used by Stanford to develop ontologies, and it will 
be the main software tool that we will use to capture and define the ontology related to 
software development tools in general and for identifying the specific ontologies related 


to specific tools (SEATools and RequisitePro). 
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C. RELATED WORK 
There is not much literature related to the development of ontologies for the 
domain of software develo pment tools. There does seem to be a lot of literature related 
to the use of ontologies for capturing the terminology of a different domain for software 
engineering purposes — i.e. to build software to support a particular domain. In fact, the 
Enterprise Ontology already presented in the beginning of this chapter is such an 
example. Another example illustrating an approach based on the use of Protégé software 
(engineering in describing the implementation of the Education and Outreach Network 
(EON) architecture) is presented below. 
1. Domain Ontologies in Software Engineering [MUSE98] 
a. Summary 
The article “Domain ontologies in software engineering: use of Protégé 
with the EON Architecture” [MUSE98] illustrates an approach based on the use of 
Protégé software. The article describes the implementation of the Education and 
Outreach Network (EON) architecture by building middleware components (reusable, 
embeddable software modules) such as a temporal database mediator for handling 
requests of time-dependent data from a patient database, domain models for multiple 
clinical specialties. It is a generic and extensible ontology for modeling clinical 
guidelines and protocols, provides an eligibility-determination server, a protocol-based 
therapy planner; and a mediator for explaining and visualizing the behavior of other EON 
components. The Medical Informatics Section at the University School of Medicine, 


Stanford, California, U.S.A developed this ontology. 


EON seeks to create an architecture made up of a set of software 
components and a set of interfaces that developers can use to build robust decision - 
support systems that reason about guideline-directed care. Moreover, according to the 
author, the capability of ontologies to encode clinical distinctions not us ually captured by 
controlled medical terminologies provides significant advantages for developers and 
maintainers of clinical software applications. The use of explicit domain ontologies and 
reusable middleware components should provide significant advantages to developers 


who wish to embed decision-support software within more general clinical information 
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systems. In the EON project, a guideline modeler uses the Protégé-2000 knowledge- 
editing environment to create and maintain models of concepts and relations in the 


medical specialty and of clinical guidelines and protocols. 


The Protégé software-engineering methodology provides a clear division 
between domain ontologies (formal descriptions of the classes of concepts and the 
relationships among those concepts that describe an application area) and domain - 
independent problem-solvers that, when mapped to domain ontologies, can solve 
application tasks. The Protégé approach allows domain ontologies to inform the total 
software-engineering process, and for ontologies to be shared among a variety of 
problem-solving components. By generating Java classes from Protégé-2000 classes and 
creating Java methods that can be invoked, the Stanford Informatics Section were able to 
add behavior to the frame-based knowledge base that Protégé-2000 provides. By using 
the CORBA technology, they were able to distribute EON components as clients and 
servers that are available from anywhere via the Internet. 

b. Concepts Related to the Thesis 

This approach is similar to the approach of the HFSE. The main 
difference between EON and HFSE is in the domain of the application — EON deals with 
unifying the domain of health care (patients and clinics) while the HFSE is devoted to the 
interoperability of software development tools; however, the use of ontologies for 
capturing and using the structure and context of the particular domain to support 
automated tools for the domain are similar. 

2. DARPA Agent Markup Language [DAML02] 

a. Summary 

The DARPA Agent Markup Language (DAML) is a new technology that 
is supporting the development of the “Semantic Web” (an improved World Wide Web 
where agents can understand the meaning of hyperlinked entities). One of the things this 
DARPA program is doing is to link together many ontologies of differ ent domains. They 


have an ontology library with over 190 ontologies. 
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b. Concepts Related to the Thesis 

Among these ontologies there are two ontologies dealing with “Software” 
[SOFT02]. Software tools which is rather small (4 classes and 11 properties) and 
“Software Engineering” [SOENO2] is a bit bigger (66 classes and 120 properties). 
However, neither of these ontologies really addresses our domain of interest (software 
development tool artifacts). The first ontology is only used for collecting summary 
information about different software development tools that someone might use, and the 
second ontology deals with annotating one specific UML based software development 
tool. These two facts represent further evidence that while there is some work in t he area, 


there is no specific work on software development tool ontologies. 


D. CONCLUSION 

Throughout this chapter, we presented the different works that served as a 
foundation for ours as well as the related (competing) work. Together, these works form 
the basis for developing our ontology and forging our methodology. This methodology 
forms the main basis and focus of this research, as well as the main contribution of this 


thesis. 
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Il. METHODOLOGY 


A. INTRODUCTION 

In the previous chapter we walked through the foundation for our work and some 
related work that dealt in some way with the interoperability and communication of 
heterogeneous systems existing in the same domain of interest. These works preceded 
ours and constitute a foundation for our software development tools’ ontology. In this 


chapter, we will present the methodology followed to achieve our goal. 


B. RESEARCH METHOD 

Because there is currently no ontology for the domain of software development 
tools, we were unable to rely on previous work and instead had to develop our own 
ontology. We were, however, able to leverage an existing methodology for establishing 
our ontology [USCH96] and tailor that methodology to our purpose. The ontology 
development process starts with identifying the purpose and scope of the ontology (step 
1). The second step (step 2) is the development of feature analysis for the selected 
domain (in this case, the domain of software development tools). This is followed by 
(step 3) reasoning and brainstorming about observations and information generated by 
the feature models to select the commonalities between the two tools and build a high 
level ontology representing these commonalities. The next step (step 4) is to build more 
detailed ontologies for each tool. These ontologies include more essential characteristics 
at a finer level of granularity. Next (step 5), we used UML to represent the relationships 
between the three ontologies. Finally, we documented the ontology (step 6). 

1. Step 1 -- Purpose of the Ontology 

The main purpose for developing an ontology for software development tools is to 
overcome some of the obstacles (such as the limitation of interoperability between the 
tools, lack of communication between the different software development tools, and poor 
shared understanding between tools) by establishing a unifying contextual framework for 
different software engineering tools. With an “ontology,” the different concepts and 


ideas in the domain will be unified. The ontology actually will determine the set of 
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semantic categories, which properly reflect the particular conceptual organization of the 
domain of information, on which the system must operate, thus optimizing the results of 
the shared information. 


2. Step 2 -- Feature Modeling 
To perform a domain analysis of the subset of tools, we proceeded by producing a 
feature model for each tool of the domain of interest. 
a. Overview of Feature Modeling 
Features are used to define software product lines and system families, to 
identify and manage commonalities ad variabilities between products and systems. 
Attempting to define a feature model for existing software tools allows us to explore, 
identify, and define the key aspects of existing software so that these aspects can be 
described in an ontology. It is this ontology that then allows us to improve 


interoperability between existing tools. 


Our approach for the analysis and the investigation of the structure of 
inputs, outputs, and relationships of a collection of individual software engineering tools 
can be characterized as a domain analysis (of this subset of tools) and the production of 
feature model of that domain. This technique is well suited for the tools’ features as well 
as the identification of their essential characteristics. Use of these characteristics in 


further steps of the research allows them to interoperate. 


Domain engineering focuses on engineering solutions for classes of 
software systems; it introduces and implements several different kinds of models, such as 
feature models. The feature model is an abstract representation of functionality found in 
the domain. It is used during domain engineering in order to obtain an abstract view on 
this functionality, which can be verified against the needs raised by the domain. 


Therefore, each feature is a relevant characteristic of the domain. 


The description of feature models was tied to the introduction of the 


Feature-Oriented Domain Analysis (FODA*) [KANG90] approach in the late eighties 


* Feature-oriented domain analysis (FODA) is a domain analysis method developed at the Software 
Engineering Institute (SEI). The method is known for the introduction of feature models and feature 
modeling. 
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[GEYEOO]. A feature model represents an explicit model of a device or system by 
summarizing the features and the variation points of the device/system. Feature models 
include the rationale (a feature should have a note explaining why the feature is included 
in the model) and the stakeholders for each of feature. A feature model for software 
system captures the reusability and configurability aspects of reusable software. Feature 
models allow us to capture the taxonomic level (the underlying organization of features 
in a feature diagram). They also provide a road map to variability in other models (e.g. 
object models, use case models, interaction and state transition diagram). Griss et al. 
describes the important relationship between use case models and feature models as 


follows [CZAROO]: 


a use case model captures the system requirements from the user 
perspective (operational requirements), whereas the feature model 
organizes requirements from the user perspective based on commonality 
and availability analysis. 


As an example, Figure 7 illustrates a feature model of a lighthouse system: 
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Figure 7. Feature Model of a Lighthouse System. 
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The feature model is defined around concepts and not around classes of 
objects. We want to model features of elements and structures of a domain, not just 
objects in that domain. We can use feature modeling together with various other 


modeling techniques such as use case modeling, and class modeling. 


Czarnecki and Eisenecker [CZAROO] slightly modified and extended what 
was introduced in FODA (features are typically arranged in a hierarchical structure that 
spans a tree) by adding some additional information, such as a short semantic description 
of each feature, stakeholders interested in each feature, constraints, availability sites (i.e., 
where, when, and to whom a feature is available), binding sites (i.e., where, when, and 
who is able to bind a feature), other attributes such as open/closed attributes (whether 


new subfeatures are expected) plus priorities (how important a feature is). 


Figure 7 illustrates of the structure of a general feature model in the 


notation introduced by the FODA approach. 


The root node (concept) of a feature tree always represents the domain 
whose features are modeled. The remaining nodes represent features, which are 
classified into three types: 


° Mandatory features are always part of the system if their parent feature is 
part of the system [GEYE00]. The mandatory feature is indicated by a 
solid circle on the edge leading to the feature (e.g., the light source in 
Figure 7). 


e Optional features may be part of the system if their parent feature is 
already in the system [GEYEOO]. The decision whether an optional 
feature is part of the system or not can be made independently from the 
selection of other features. The optional feature is indicated by an empty 
circle at the edge leading to the feature (e.g., the light sensor in Figure 7). 


e Alternative features are connected via an exclusive or relationship, i.e. 
exactly one feature out of a set is part of the system if the parent feature is 
part of the system [GEYEO00]. A typical alternative feature set is indicated 
by an arc connecting the edges leading to the alternative features (e.g., the 
two features automatic and manual in Figure 7). 


e Additionally, features in a domain are of two categories: comm on and 
variable [GEYE00]. Common features are always part of a system in the 
regarded domain (a feature present in all instances of a concept). Variable 
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features are only part of some systems. The classification of a feature is 
determined by its type, and by its position in the feature tree. Common 
features are always mandatory. Another prerequisite is that there are only 
mandatory features in the path from the root node to the common feature. 
Optional and alternative features are always variable (e.g., in Figure 7, the 
battery feature is common feature, and the eclipser feature is not). 


b. Feature Modeling 


To perform feature modeling, we have to know the sources of features, 


identify features, and finish by following some general steps in feature mode ling 


[CZAROO]. Sources of features include the following. 


Existing and potential stakeholders, 

Domain experts and domain literature, 

Existing systems, 

Pre-existing models (e.g., use-case models, object models...). 


Models created during development (i.e., features gotten during design 
and implementation). 


Strategies for identifying features [CZAROO]: 


Look for important domain terminology that implies variability, during 
feature modeling, we document not only functional features but also 
implementation features. 


Examine domain concepts for different sources of variability: what 
different sets of requirements do these variability sources postulate for 
different domain concepts? 


Use feature starter sets to start the analysis; a feature starter set is a set of 
perspectives for modeling concepts. 


Look for features at any point in the development. Update and maintain 
feature models during the entire development cycle. 


Identify more features than you initially intend to implement in order to 
create some room to grow. 


General steps in feature modeling: 
Record similarities between instances (i.e. common features). 
Record differences between instances (i.e. variable features). 


Organize features in feature diagram, into hierarchies with classification 
(mandatory, optional, alternative, and/or optional alternative features). 


Analyze feature combinations and interactions. 
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e Record all the additional information regarding features. 
All the previous steps are referred to as the “micro-cycle” of feature 


modeling because they are usually executed in small, quick cycles. 


The feature tree is the basic description of a feature model. It defines a 
hierarchical structure over the set of features of a domain, thereby defining the parent - 
child relationship between different features. But typically there are more relationships 
between features. One relationship is called “Or-Features” [CZAROO]. This relationship 
connects a set of optional features with a common parent feature. The meaning of the 
relationship is that whenever the parent feature is part of a system, at least one of the 
optional features in the set has to be part of the system. Czarnecki and Eisenecker 
[CZARO0] extended the FODA notation so that this relationship can be expressed in the 


feature tree. 


Other types of relationships which cannot be expressed with the feature 
tree notation are the “required” and the “excluded” relationships [CZAROO]. The 
required relationship connects two variable features such that if one of the features is 
chosen to be part of the system, the other feature has to be chosen, too. The excluded 
relationship states that only one out of a set of features can be part of the system (e.g. in 
Figure 7, if the automatic control feature is chosen, then the light sensor and the eclipser 


feature have to be chosen). 


Some relationships such as “default features” or “feature combination 
recommendations” cannot be expressed in the tree notation. Typically they have to be 
defined in an external representation. One solution to extend the use of this approach 
(feature modeling) would be to extend UML with feature diagram notation. This would 
prove a popular solution given the high level of acceptance of the UML in the software 
industry. 


Cc. Feature Tree of Selected Software Engineering Tools 
(RequisitePro and SEATools) 


In order to exploit the approach of feature modeling in a constructive way 
for our application and show the eventual interoperability of some software engineering 


tools, we built feature diagrams for the following tools: RequisitePro requirements 
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management tool and the Software Engineering Automation Tools (SEATools). The 
choice of these tools was tailored by the fact that this subset includes both a commercial 
and research tool and represents substantial elements of the software development 
process itself. 

3. Step 3 — Establishing Commonalities 

After producing a feature modeling for each tool (RequisitePro and the 
SEATools) of our domain of interest, we established the commonalities existing between 
the two feature models as for their feature trees, and the common artifacts existing in the 
two tools. The establishment of these commonalities was the result of reasoning and 
brainstorming about the information generated by the feature models to select the 
commonalities between the two tools. The lists of features were generated and combined 
in a high-level parent-child relationship. Moreover, the lists contain not only the 
common features of the two tools in question, but also the common features of many 
other software development tools as well. 

4, Step 4 — Tool Ontologies 

Since we choose how to represent the essential characteristics for each tool in an 
ontology, we are making design decisions. In this case our ontologies are initially 
informally described. To guide and evaluate our designs, we need objective criteria that 
are founded on the purpose of the resulting artifact. We did our best to make our 
ontologies follow some criteria that we judged necessary for knowledge sharing 
[GRUB95]. In terms of clarity, our ontologies should effectively communicate the 
intended purpose for which they were built. Definitions are given as objectively as 
possible. When a definition can be stated in logical axioms, we did that. All definitions 
are documented with natural language. 


e Coherence: the software development tools ontologies, if necessary, 
sanction inferences that are consistent with the definitions. 


e Extendibility: the potential objective of our work is to build an ontology 
that anticipates the uses of the shared vocabulary. The hope is that our 
ontology will serve a framework or foundation for further extensibility. In 
other words, one should be able to define new terms for special uses based 
on the existing vocabulary, or include other software development tools in 
a way that does not require the revision of the existing definitions. 
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e Minimal encoding bias: avoid making biased choices. Choices were not 
made purely for the convenience of notation or implementation. 


e Minimal ontological commitment: the software development tools are 
developed in a way that the emphasis was on minimal ontological 
commitment to support the intended knowledge sharing activity. 


5, Step 5 - UML Representation of the Domain 

Since our ontology is mainly developed to catch the commonalities between the 
different artifacts associated with two different software development tools, serving as a 
dictionary allowing communication and interoperability between these tools, we choose 
the usage of the Unified Modeling Language (UML). The use of UML for our ontology 
representation would help to show the inter-relationships between classes and 
inheritance. 

6. Step 6 -- Documentation 

Documentation involves the recording, maintaining, and reporting of each step 
undertaken in each phase of the process established to develop the softwar e development 
tool ontology. It includes all plans, meeting schedules, reports for the work done and 
decisions taken. However, special attention was put on the specific documentation such 
as the features lists (from the rough features lists to the ontolo gy filtered list), the feature 
diagrams representing all the features selected, the Protégé databases including the three 
ontologies developed for the purpose of the research, the UML diagrams showing the 
class diagrams for each ontology and the relationship that exist between the UML 
diagrams for each tool used in this research and the high level UML diagram representing 
the high level ontology. The ontology documentation was updated as something changed 


with time and as decisions were made during reviews . 


C. CONCLUSION 

This chapter presented the methodology to develop the software development tool 
ontology. The process starts with identifying the purpose and scope of the ontology, 
followed by the development of feature analysis for the domain of software development 
tools, then reasoning and brainstorming about the information generated by the feature 


models to select the commonalities between the two tools and build a high level ontology 
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representing these commonalities. The next step was building more detailed ontologies 
for each tool before using UML to represent the relationships between the three 


ontologies, and the final step was the documentation of the ontology. 
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IV. ESSENTIAL TOOL CHARACTERISTICS 


A. INTRODUCTION 

In the previous chapter, we presented the methodology used to develop an 
ontology for software development tools. We identified the domain analysis as part of 
the methodology to generate the essential tools characteristics. In this chapter we are 


going to isolate and explain the domain analysis. 


B. DESCRIPTION OF THE RATIONAL REQUISITEPRO 

Managing requirements is one of the most significant factors in delivering 
projects on time, and on budget. RequisitePro helps projects succeed by giving teams 
(project managers, quality assurance managers, testers, developers, etc.) the ability to 
manage all project requirements comprehensively, while facilitating team collaboration 
and communication. It increases the likelihood of delivering qua lity systems on time and 
on budget. Rational Software Corporation's RequisitePro is a flexible and easy -to-adopt 
requirements management tool, used for documenting and managing requirements 
throughout the software lifecycle. Requirements documents, under RequisitePro control, 
can be created, modified and managed, and are complemented with database information, 
such as requirement attributes, traceability relationships, and revision history. 
Additionally, email-enabled discussion groups capture the team feedback on project- 
wide or requirement-specific issues [RATIO2]. Customers can use RequisitePro’s 
predefined project structures out-of-the-box or simply define their own. Moving beyond 
conventional requirements management, RequisitePro combines both doc ument-centric 
and database-centric approaches. By deeply integrating Microsoft Word® with a multi- 
user database, RequisitePro enables the organization, prioritization, and the easy tracking 
of requirements’ changes. RequisitePro can also be extended usin g the RequisitePro 
Extensibility Interface, a Component Object Model (COM)-based Application 


Programming Interface (API), which allows programmatic access to requirements. 
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RequisitePro provides: 


e access to all requirements for every team member, by using acentral 
database, 

° an easy way to query requirements information for all team members, 

e an easy way to check for requirement coverage. 


Developers can use RequisitePro to: 

e document in detail all features defined by marketing, 

e provide quick and easy impact analysis tailored to each team member. 

Developers can quickly review the impact of changed marketing requirements on 
their specifications; documentation writers can quickly review the impact of any 
requirement change on the user manual. Either the Windows client (Rational 
RequisitePro) or the Web client (Rational RequisiteWeb) allows users to create, view and 
modify requirements stored in a commercially available database (Microsoft Access, 
Microsoft SQL Server or Oracle). In RequisitePro, requirements ar e organized by type. 
Each requirement type provides a set of requirement attributes, which can easily be 


modified [UNDE02]. 


RequisitePro provides an Import Wizard that allows the user to easily extract 
textual requirements from external Microsoft Word documents or databases stored in a 
Comma Separated Value (CSV) format. When importing from Word documents, the 
requirements, the entire document, or both can be chosen for import into the project. 
CSV files need not be created by Requisite®Pro and may include files saved by 
Microsoft Access, Microsoft Excel, or other databases capable of saving data in the CSV 


format. 


In summary, while RequisitePro's ability to manage text-based artifacts is 
excellent, its capacity to handle graphics-based artifacts is limited by the functionality 
provided by Microsoft Word. The “views workplace” is the primary tool used for 
requirement analysis (including linking and tracing) and report generation. From a view, 
the user can modify artifacts, artifact attributes, and trac eability relationships. In 
addition, requirements can be viewed and be opened simultaneously. Thus it provides a 


powerful query facility for viewing requirements any time within the context of its parent 
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document. RequisitePro allows multiple views and their relationships. View formatting, 
loading, saving, and printing are supported. RequisitePro can also export views using 
any of several formats including Microsoft Word. RequisitePro is an effective text -based 
artifact manager with a limited capacity to handle non-text objects [EVAL02]. 

1. RequisitePro Feature Analysis 

In the feature analysis of RequisitePro, “Projects” are found to be the top-level 
objects. Projects are used to define documents, requirements, and requirement attribute 
types and provide a mechanism for enabling or disabling the RequisitePro's security 
features. Each RequisitePro project is maintained in its own sub-directory and consists 
primarily of a database file and the project documents. The project database include the 


following information: 


° attribute values, 

e traceability relationships, 
e requirement types, 

° attribute definitions, 

e document types, 

° revision histories, 

° security information, etc... 


Requirements (in either the “Word Workplace” or a “View Workplace”) may be 
easily created, edited, or moved. The user can establish relationships among 
requirements. Requirement types, as with document types, are user definable. 
Requirements possess attributes and may be arranged in a hierarchy in which each 
requirement level depicts increasing amounts of detail about the related high-level 


requirement(s). 


Documents are essentially Microsoft Word documents and rely on the project 
database for the efficient management of requirements and their attributes. Document 
types are user-definable and instances of documents may contain product requirements, 


requirement specifications, use cases, test cases, or any other user-specified requirement 


types. 
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Attributes facilitate requirement management by allowing the user to define 


properties describing a requirement. These properties include: 


Status, 
Authors, 
Security, 
Priority, 
Stability, 
Version, 


Date, etc... 


Attribute values may contain text, numeric data, or may be obtained from user - 


defined lists. Attributes are associated with a particular artifact type and can vary from 


project to project. Attribute and requirement type definitions from previous projects can 


be reused if desired. If the attributes supplied by RequisitePro are insufficient, the user 


has the option of defining his own requirement attributes. 


Several major features of RequisitePro address the control of access by multiple 


users. These features, which provide control at both the project and document level, 


include: 


Open Project/Document Options. When opening a project, the user is 
given the option to open as Read Only, Exclusive, or both. The Read 
Only option gives the user the ability to view but not change the project or 
its documents. Exclusive access is available to only one user at a time and 
can only be used when another user does not already have the project 
open. This mode enables the user to delete items such as document types, 
requirement types, attributes, and values without disrupting work 
elsewhere. The Read Only and Exclusive options can be combined to 
prevent all users (including the current user) from making changes to the 
project while the current user has the project open. 


Security Options. The security features of RequisitePro determine the 
availability of the Open Project/Document options. Read, update, and 
create/delete permissions for specific document and requirement (artifact) 
types can be assigned to groups. Where applicable, read and update 
permissions can also be assigned for requirement attributes and attribute 
values. 


Document Locking. Document locking is a less restrictive form of access 
control than the options provided by the Open Project/Document dialog. 
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Locking applies only to a selected document and prevents the modification 
of text, formatting, graphics, etc. while allowing document and 
requirement (artifact) properties and relationships to be updated in the 
database. 


Display Updates. RequisitePro updates the Word Workplace when the 
requirement text in the document is modified and the document is saved. 
The “Refresh All” command on the View menu permits the refreshing of 
each open view and forces the query for each view to be rerun. 


All of this information represents an archetype of the analysis of features. Each 


feature was analyzed by reading about its functional and non -func tional effect and by the 


use of the tool itself. Furthermore, we analyzed, described and documented their actions. 


2. 


Key Functions of RequisitePro 


Below are some of the essential features provided by the Rational RequisitePro 


tool. It is not necessary that all these features show up in the ontology list presented in 


the follow-on discussion, but they do provide a starting place for capturing important 


concepts for the feature tree: 


3. 


Parses a source document to load requirements into database; 


Synchronizes textual Software Requirements Specification (SRS) with 
database contents; 


Defines different attributes for different types of requirements and set 
attribute values for individual requirements; 


Defines traceability relationships or links between individu al requirements 
and between requirements and other system elements; 


Tailors usability options; 
Includes learning aids, such as a tutorial and/or sample projects; 


Integrates with other tools, such as testing, design, and project 
management; 


Defines users and groups and their access privileges; 
Enables threaded discussions on requirements; 


Includes web interface for database query, discussion, and the updating of 
requirement attributes. 


Feature Tree of RequisitePro 


The complete RequisitePro feature tree is presented and explained in Appendix B. 


The following feature tree in Figure 8 is a portion of the tree presented in Appendix B. 
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This part illustrates the detailed analysis undertaken to track the essential characteristics 


of RequisitePro. 







Treacability 


Track all the 
requirements 


Set 
requirements Organize 
relationships 


Identify high Capture 
level requirements 
requirements changes 


View chain of 
relationships 


Categorize 
requirements 


Understand 


Sort Filter Requirements Classify by classify by 


impact of | Review changes 


requirements requirements 
changes 


maintainability types status 


Figure 8. Subset of the RequisitePro Feature Tree. 


As shown in Figure 8, the “track all the requirements” is divided into two 


“ce 


mandatory features “set requirements relationships” and “organize”. The “set 
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requirements relationships” feature is also divided into two mandatory features. The 
“identify high-level requirements” feature is divided into two mandatory “Or-features”. 
Furthermore the “‘categorize requirements” feature, derived from the “organize” feature is 
divided into two alternative-optional features either “classify by types” or “classify by 
status”. 

4. Ontology List 

The essential characteristics of the RequisitePro tool resulted from the analysis of 
the tool and the feature diagram of the tool. These features represent potential ontology 
terminology and are listed in the list below. Key artifacts with their actions (behaviors 
and attributes) begin to represent the ontology for the Rational RequisitePro tool, and will 
be essential in distinguishing and identifying commonalities with features from other 


tools (such as those of the Software Engineering Automation Tools (SEATools). 


1 Rational RequisitePro_ | Requirements management tool 


2 Management Documenting and managing requirements throughout 
the development lifecycle 


3 Requirements Including linking and tracing and report generation 
analysis 

Non-functional The subset of non-functional features such as 

features integration with other tools, security, and remote 

usage via web 


1 
RequisitePro 
epee aunaeameer | 
collaborative environment 
Capture, communicate, organize, and track the 
information 


Set up new project Allows the user to create new project templates from 
template existing projects 


from project list 
Allow the revision of the project 
revision 


11 Unify teams Unify project managers, QA managers, testers, 
developers, etc. in communicating and managing 
systems requirements 


12 Allow Interaction Records the thought process behind decisions made 
with stakeholders about requirements 
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Customers can use Rational RequisitePro's 
project templates predefined project structures or define their own 
Requirement metrics provide project managers with 
statistics those statistics are displayed in Excel 
database 
16 


Synchronize textual Synchronize textual SRS with database contents 
Software 


Requirements 
Specification (SRS) 


17 Manual revision of Allow manual revision of the project 
the project 
18 Automatic revision of | Allow automatic revision of the project 
the project 
19 Notify teams Keep everyone informed of the current requirements 
information 


Discuss and quer Enables threaded discussions on requirements 


21 Provide collaborative | Allows the collaboration among the team 
design environment 


Record comments Provide a way to record comments 


collaborative team 
Synchronization information 


Improve Efficiency Provides mechanisms for better communication 
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Improve Everyone informed of the current requirements 
Understandability information with traceability to early design 
decisions 


Effectiveness 

Provide access to all requirements for every team 
documents member, by using a central database 
documentation 


Provides a document repository 
Allow the archiving of old documentation 


changes documentation 
33 Monitor linking Defines traceability relationships or links between 
individual requirements and between requirements 
and other system elements 
34 Set up links Create relationships between artifacts in either the 
35 : : : : 


Identify and clear Relationships between previously linked 
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suspect links requirements are marked as suspect if the text, type, 
or attributes of either requirement is changed. This 
relationship can be cleared in either Word or View 
workplaces 


Automatic set to Allows links to be automatically set to “suspect” 
“suspect” 


“suspect” 
suspect links 
suspect links 
(PROBES [rong between eguronens | 
relationships between requirements 
control at both the project and document level 
Workplace 
Workplace 
Fea OR 
creation 
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Update requirements | Updates the Word Workplace when the requirement 
text in the document is modified and the document is 
saved 

[46 Add requirements | Add requirements to the project database ———=* 

47 Delete requirements | Enable the user to delete items such as requirement 
types, and attributes without disrupting work 
elsewhere 


Provide Define different types of requirements 
requirements’ type 


Assign attributes to Defines different attributes for different types of 
requirements requirements and set attribute values for individual 
requirements 


requirements 
requirements 


Provides a change “pending” function, until the 
temporarily change is appropriately approved 
requirements 


Facilitates Developers can assess whether they have 
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requirements documented in detail all features 
coverage analysis 


View approved use- | Connects requirements with use-case models 

case instantly accessible by developers. It helps to ensure 
that the implemented functionality reflects the 
customer needs 


57 Track all the Provides views that track the status and attributes of 
requirements all the requirements 

58 Set requirements Establish relationships among requirements 
relationships 

59 Organize Requirements are organized by type 
Requirements 
Establish requirement | Arrange the requirements’ attributes in a hierarchical 
hierarchies way 

61 View chain of View the requirements’ chain of relationships 
relationships 


Sort the requirements | Allow the sorting of the requirements 


63 Filter the Allow the filtering of the requirements 
requirements 


Facilitate the Provide easy impact analysis tailored to each team 
Understanding of the | member 
impact of changes 


Automatically generates user defined reports 


Pes ome ceallemm eee ee 
options options 
discussion, and for updates to requirement attributes 
ere ee eee eel 
projects 


Word environment Fits in customers’ environment, making it easy to use 
and import wizard and adopt and allows the user to extract textual 
requirements from external Word documents 


Integrates with other tools, such as testing, design, 

software tools and project management 
errors are identified early and fully corrected 

mechanisms to specific groups 

Using the Web access ensures that the stakeholders 
of document always see the most-up-to-date requirements 
understanding context from which a requirement has been derived 
privileges 
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Apply locking only to selected documents 


Table 2. | RequisitePro Ontology List. 


This ontology list is derived from the feature tree; the order given here to the 
features is represented by the order of the features in the different layers of the tree. The 
layers are read in a top down approach. The references are allocated to the features 
horizontally from left to right layer-by-layer. See Appendix B to get a clear picture of the 


feature tree structure of this potential ontology terminology. 


C. SEATOOLS 

1. Introduction 

Software prototyping evolved as an effective solution to tackle problems 
generated by the fact that most of the time there is a mismatch at the end of the coding 
phase of project development between the product delivered and customer expectations 
of what that product should have been. Leffingwell and Widrig in their book Managing 
Software Requirement: A Unified Approach present three concepts that describe the 
underlying reasons for this mismatch [LEFFOO]: 1) the “Yes but...” concept -- where the 
user generally likes what he sees but wants changes, 2) the “Undiscovered Ruins” 
concept -- where the user sees a piece of functionality that leads him to desire additional 
(previously unstated) functionality, and 3) the “Mary had a little lamb” concept -- where 
the developer misunderstood what the customer wanted because of semantic ambiguity in 
the natural language expression of the customers’ requirements. The customer finds the 
final product is not exactly what he/she expected, new ideas triggered his/her request to 
add new requirements, or the developer misinterpreted the customer requirements. This 
mismatch in expectations drives the necessity for effective prototypes (constructed and 
modified rapidly, accurately, and cheaply) [LUQI91]. 


2. Description of the Software Engineering Automation Tools 
(SEA Tools) 


Prototyping is the development of an archetype of the final product summarizing 


all (or some) of the requirements and the specifications requested by the customer. 
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Furthermore, the archetype is presented to the customer for evaluation and eventually 
provides the developer with the feedback necessary to determine the degree to which the 
requirements applied on this scaled down version map to his expectations. As a result, 
adding additional requirements, or changing requirements can be done cheaply and 


efficiently at this stage of development. 


Prototyping has become more feasible with the advent of automated tools 
developed to generate the necessary code satisfying specific requirements [BERN96]. 
Because time schedules, input and output variables, and target languages are crucial in 
real-time embedded systems projects, rapid software prototyping has emerged as a 
special type of prototyping that allows for improved analysis and design of software 


systems [DURA99]. 


A good example of a tool available for such purposes is the Software Engineering 
Automation Tools (SEATools). This tool was developed by the Naval Postgraduate 
School, Software Engineering Group. This group has recognized and extolled the use of 
computer-aided prototyping in software development as a way to boost the efficiency of 
software projects through understandable requirements and validation of the system 
design. Concerning the return on investment (ROJ), the use of prototyping seems to 
generate more benefits than without it. As an illustration, Bernstein in his article 
“Forward: Importance of software Prototyping” estimated a net return of $.40 within the 
life cycle of the system development for every $1 invested in prototyping [BERN96]. 

3. Evolution of the SEATools 

The original version of SEATools evolved from an integrated collection of tools 
that generated source programs directly from high-level requirements specifications 
[LUQI88]. Figure 9 illustrates the major functions and components of SEATools 
(formally called the Computer Aided Prototyping System (CAPS)) accessible via a user 
interface. SEATools provides computer aid for rapidly and inexpensively constructing 


and modifying prototypes [LUQI96]. 
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Software Base 











Figure 9. General Structure of the SEATools Environment [USERO2]. 


SEATools was originally developed using the C and Ada programming 


languages, and implemented in a UNIX environment. It consisted mainly of three 


subsystems: 
e Editor subsystem, 
e Execution support subsystem, and 


e Software base subsystem [MCDO01]. 

Over the past five years CAPS has slowly begun a transition from UNIX based 
systems to a system capable of running on multiple platforms to include Linux and 
Microsoft Windows utilizing the portability of the Java programming language. The 
system has now been successfully ported to the Java language and implemented in a 


standalone version on a PC. 


The editor subsystem contains: 

e A Prototype Software Development Language (PSDL) editor, 

° An Ada editor, and 

e An interface editor. 

The execution support subsystem embodies: 

° A translator, 

° A scheduler, and 

e A compiler. 

The software base subsystem is part of a software database system. It is 
characterized by its ability: 
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e To track all the PSDL description and Ada implementations for all 
reusable software components in CAPS. 


e To provide reusable software components for each prototype previously 
developed in CAPS that has a complete PSDL specification and 
executable code. 


The SEATools process follows four essential prototyping stages as shown in 


(Figure 10). 
e Software system design, 
° Construction, 
° Execution, and 
e Requirements evaluation/modification 


Generate initial 


requirements 





Reusable 
Software 










DBMS 


Software Design 
Database Database 










Construct/modify 
prototype design 





Generate target 
source code 


Demonstrate 
Prototype 





Modify 
requirements 


Execution 
Support 
System 






Figure 10. Iterative Prototyping Process [LUQIO2]. 


Each prototype design starts by identifying and analyzing the problem to be 
solved, followed by deciding about the parts to be prototyped. Then, the designer draws 
dataflow diagrams using the SEATools PSDL editor. Finally, the prototype is translated 
into the target programming language for execution and evaluation. The design database 


assists the designers in managing the design history. 
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4. 


Summary of Functionality 


SEATools has been shown as a powerful research tool in prototyping large 


complex embedded software such as the command-and-control station, cruise missile 


flight control system, missile defense systems. As stated by Ludi et. al. [LUQIO2] 


SEATools demonstrated payoffs include the ability to: 


Formulate/validate requirements via prototype demonstration and user 
feedback, 


Assess feasibility of real-time system designs, 

Enable early testing and integration of completed subsystems, 
Support evolutionary system development, integration and testing, 
Reduce maintenance costs through systematic code generation, 
Produce high quality, reliable and flexible software, 

Avoid schedule overruns. 


Feature Analysis 


SEATools provides the following kinds of support to the prototype designer: 


Computer-aided design, 
Computer-aided software reuse, 
Time checking, 

Consistency checking, 
Configuration management, 


Evolution Control System. 


The feature model described in the SEATools feature tree (Appendix C) 


illustrates the different features that make this support possible. This feature model 


defines a hierarchical structure over the set of features of the tool. The features in the 


feature tree summarize the results of the SEATools features’ analysis as follows: 


All the features represent the important domain terminology that imply 
variability (not only functional features but also implementation features 
were documented). 


All the features representing the different sets of requirements postulated 
by different variability sources for the SEATools domain concept. 


All the high level features appeared to be feature starter sets to start the 
analysis (recall that a feature starter set is a set of perspectives for 
modeling concepts). 
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e The features reported in the feature tree are colleted throughout the 
development. Some of them are updated and maintained during the entire 
development cycle. 


e The features represented in the feature model are selected among more 
features initially intended to be implemented. 


e All kinds of features (mandatory, optional, and alternative) were identified 
and represented and present in the feature tree. 


To illustrate these points, below is a part of the SEATools feature tree taken from 
the complete feature tree in Appendix C. This “subset” was chosen for its representation 


of some of the features cited above. 
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Caps hardwe 


create a A 7 F 
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OTHER TEXT 
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Figure 11. Subset of the SEATools Feature Tree. 


Figure 11 demonstrates the different features derived from the feature “edit”. 
These features are all (by chance) “mandatory-features”. However, the very lower level 
feature “other text editor” is divided into two mandatory features, but their choice is 


alternative. 
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Figure 12. Timing Constraints Subset of the SEATools Feature Tree. 


The timing constraints in SEATools depend on the operation itself, and as shown 
in Figure 12, consists of: Maximum Execution Time (MET) that represents the longest 
time between beginning and completion of execution, Minimum Calling Period (MCP) 
representing the minimum time between two successive activations, and the Maximum 
Response Time (MRT) showing the longest time between input stream write output 


stream write. 


Once completed, the feature diagram was analyzed to identify potential ontology 
terms. These terms were compiled into a SEATools Ontology List. 


6. SEATools Ontology List 

We arrived at the essential characteristics of SEATools by analyzing the feature 
model. Potential SEATools ontology terms are compiled in this list. The artifacts with 
their actions (behaviors and attributes) represent possible ontology terminology for the 
SEATools, and will be essential to distinguish and identify commonalities with features 


from other tools such as those of the RequisitePro. 
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1 SEATools Software engineering tools (integrated collection of 
tools) for developing prototypes of real-time 
systems 
Management prototype Manage prototypes 
Build prototype Build prototype 


Develop systems Develop functional prototypes 


ipa Analyze requirements Analyze requirements through — evolutionary 
prototypes 
7 Automatic generation of the code 


Model editor The SEATools editor that helps a user create a 
model 
[9 | Modification Modify existing prototypes and graphs 
Graphical editor GUI interface for data-flow diagrams 


11 Expert-system design | Provides a user interface that allows the user to 
mode access SEATools 


Debugger Finds errors in the model 
pag” Btw — Allows user to browse the model 


13 
Evolutionary prototype Support evolutionary prototyping 
Feasibility Assure Feasibility study 
Assure control of projects via the use of merger 
17 Interaction Allow interaction with the proposed system with its 
environment 
Limitations in a development effort 


One of the five categories of the SEATools 
software 
Execution supportsystem | The windows in which SEATools initially invoked 


Creation Allow the creation of a prototype, PSDL, and 
graphs. 


19 
20 
21 
22 Allow adding information to an existing prototype 
23 
24 
5 


Refine systems Allow changes in an existing prototype 


Allow the deletion of undesired information 


Allow communication Allow communication between different parts in the 
model 
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Control communication Control communication between different parts in 
the model 


a of complex | Support integration of complex systems 
systems 


Evolution control systems | Provide an automated support for coordinating the 
efforts of a team of prototype designers and manage 
multiple versions of the designs they produce 


Provides automated prototype change -merging 
| 33 Software design Management software design 


pee base Allow persistent storage of prototype 
aeveinoniea data 
Allow the translation from PSDL to Ada code 
Ea i Creates schedules for Ada code 
Compiles the source code 


Ei i system Executes all the Ada code for the currently open 
Design eprooype in the designer’s private workspace 
[t= ——— One Fis ea the potential stakeholders in a project 


}4t [Prototype A | A sample fortepresenting the requirements for representing the requirements 

Le Assist the ee engineer when requesting 
information about one of the menu buttons 

Edit Allow the choice from a list of commands include 
PSDL, Ada,, Requirements... 


Essential A category of differentiation for the following 
SEATools (user interfaces, editors, the execution 
support system, the project control system, and the 
software base) 

45 Very useful A category of differentiation for the following 
SEATools (user interfaces, editors, the execution 
support system, the project control system, and the 
software base 

Useful A category of differentiation for the following 
SEATools (user interfaces, editors, the execution 
support system, the project control system, and the 
software base 





Warns of any existing conflict 


Design database | Contains the PSDL descriptions and working code 


containing PSDL for all available reusable software components 


Allow the construction of a prototype 
Allows the user to create a prototype design 
Allow to quit and close the SEATools program 
Allows prototype design to be entered into the 
database 
Retrieve from database Allows the user to retrieve data from the database 
Allow the choice of a project 


PSDL User friendly tool that helps the user/software 
engineer construct prototypes using a combination 
of graphical and textual objects 
Plus* (TAE+) to edit the prototype interface 


Caps default Allows designers to choose which text or Ada 
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52 
53 
54 
55 
56 
57 
58 

9 


5 


editor will be used 


Hardware model Lets designers check timing constraints relative to a 
machine faster or slower than the machine that is 
executing CAPS 

Operating systems Allows models to account for operating systems 

Allows models to account for compiler 

Programming language Allows models to account for language 

Computer systems Allows models to account for computer systems 

PSDL specifications Track PSDL specifications 

Executed code Track executed code 


61 
62 
63 
65 

7 


6 





* Transportable Applications Environment Plus (TAE+) is a windowing package developed at the 
National Aeronautics and Space Administration’s Goddard Space Flight Center. TAE Plus provides either 
Ada or C code to create the user interface modules. 
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70 Graphical objects (data | Allow the construction of data flow diagram 
flow diagram) 
71 Textual objects Allow textual objects 
72 i 
73 
74 
5 


ae | Data flow diagram Show Existing data flow diagram 


Library reused code Allow the use of a Library of reused code 
82 Control constraints Control the process and output generation via a set 
of conditions or predicates 
83 Operators Allow the drawing of operators (circles) in a data 
flow diagram 


Streams Allow the drawing of data streams (directed lines) 


in a data flow diagram 


Allow the drawing of terminators (rectangles) in a 
data flow diagram 

ee ee ee 
and edit Ada code 

lee  ——"dldaeekwea 
and edit Ada code 

ee 
and edit Ada code 


Table 3. SEATools Ontology List. 





This ontology list is derived from the feature tree; the order given here of the 
features is represented by the order of the features in the different layers of the tree. The 


layers are read in a top down approach. The references are allocated to the features 


60 


horizontally from left to right layer-by-layer. See Appendix C for a full picture of the 


feature tree structure of this potential ontology terminology. 


D. COMMON CHARACTERISTICS OF THE TOOLS 

Recall that features in a domain are of two types: common and variable. 
Common features [GEYE0O] are always part of a system in the regarded domain (a 
feature present in all instances of a concept). Variable features are only part of some 
systems. However, in this part of the analysis the aim was to collect the common 
characteristics for both tools (Rational RequisitePro and SEATools) that may be present 


in other tools as well. 


We conducted an approach of reasoning and brainstorming about observations 
and information generated by the feature models to select the commonalities between the 
two tools and build a high level ontology representing these commonalities. We 
identified some common characteristics which are features generated in the feature trees 
as fundamental ones at an abstract level. These same generic features are likely to be 
found in other software development tools. This makes the software development tool 
ontology a “pilot” ready for further extension so that it may later include other software 


development tools. 


Here is the list of the common essential characteristics of the tools that allowed us 


to build a high level ontology that will be further explained in the following chapter. 


1 Tool The tool intended to be analyzed and to 
incorporate its essential characteristics into an 
ontology tailored to this purpose 


ee ieee A particular role adopted by the user of an 
application while participating in a use case 


—— A person, group, or organization with a stake 
in the outcome of an application that is being 
developed 

The software engineers who develop a 
software project 


2 Designers The software engineers who design a software 
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Architects The software architects for a particular 
software project 


The team involved in any software project 


Activity Specify the activity, which is anything that 
involves doing. 


19 ~~ | Communication Assurance thorough transmission 


10 Management Assure control over a project or apart of a 
software project 


11 Organization Allow the arrangement of the software 
requirements of any other information related 
to a software project. 


Allow the arrangement of a software project 
information in a given order 

Allow the removal of undesired information 
via specific criteria 

Allow the software project stakeholders and 
information to operate at the same rate and 
time 

Allow the archiving of particular documents 
related to the activity 

Allow the establishment of the process of 
repairing and enhancing an application. 

Allow the creation of components judged 
necessary for the activity 


Allow changes 


Verification Ensure that a software application is being 
built in the manner planned 


21 Artifacts Any kind of data, source code, or information 
produced, gathered or used during the 


Documentation 


24 Database Provide a collection of arranged data for easy 
and fast retrieval 


Feedback Allow feedback 


Efficiency Provide high quality by improving the process 
Assure the relationships between the different 


Links_Dependencies_Treaca | information and requirements related to a 
bility software project 


Avoid risk and danger 





Child Parent Assure and identify the _child-parent 
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P| relationships in the software project | 


project. 

33 Requirements Allow the obtaining of a complete statement 
of what functionality, appearance, and 
behavior are required of an application 

Model A view of the design of an application from a 
particular perspective, such as __ the 
combination of the application’s classes, or its 
event-driven behavior 


Case A sequence of actions, some taken by the 
ees Veto and some by the user, which are 
common in using an application 


i? Building a collection of information and 
material related to a project 
37 Prototype An application that illustrates or demonstrates 
some aspects of an application that is under 
construction 
Assure the determination, the quality, and the 
truth of a software project 


Table 4. Common Characteristics for High-Level Software Development Tools Ontology. 





This list was the result of the analysis of the two ontologies lists representing 
RequisitePro and The SEAToolss. It was generated after brainstorming about the more 
frequent features that exist in almost all the tools. These features represent the high level 


ones. 


E. CONCLUSION 

In this chapter we presented and explained the domain analysis and identified the 
essential tools characteristics. For both RequisitePro and SEATools we described each 
tool, explained our approach to analyze the features, and identified ontology lists for each 
tool. Finally, we illustrated the common characteristics existing in both software 
development tools. Accomplishing the previous steps leads us to the next step “building 


the software development tool ontology.” 
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V. THE SOFTWARE DEVELOPMENT TOOL ONTOLOG Y 


A. INTRODUCTION 

This chapter discusses and presents the software development tool ontology as a 
collection of classes using the Unified Modeling Language (UML). The ontology is 
intended to be used in conjunction with formal models of the software development tools 
domain (such as within an interoperability model of the domain), and thus it is important 
that the language used to describe the ontology have formal semantics. Unfortunately, 
such formal semantics are not provided for in UML. However, UML has become a 
recognized and highly used standard for describing the relationships of objects. UML 
also has a very large and rapidly expanding user community. Therefore, we propose to 
use UML to illustrate the logical associations between key elements of the ontology (i.e. 
class names and relationships), but will rely on Protégé to record any formal semantics 


(such as constraints within or between classes). 


B. OVERVIEW OF UML 

The Unified Modeling Language (UML) helps in specifying, visualizing, and 
documenting models of software systems, including their structure and design. UML 
defines twelve types of diagrams [INTRO2], divided into three categories: four diagram 
types to represent static application structure; five diagrams to represent different aspects 


of dynamic behavior; and three diagrams to organize and manage application modules: 


e Structural Diagrams include: the Class Diagram, Object Diagram, 
Component Diagram, and Deployment Diagram. 

e Behavior Diagrams include: the Use Case Diagram, Sequence Diagram, 
Activity Diagram, Collaboration Diagram, and Statechart Diagram. 

e Model Management Diagrams include: Packages, Subsystems, and 
Models. 


Among the UML diagram types that can be used to model the static and dyna mic 
behavior of a system, we have chosen to model our ontology as a static model consisting 
of a class diagram to depict the classes in the domain and their relationships. 


Additionally, we use Packages as parts of Model Management Diagrams as well. All 
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three ontologies are described as class diagrams and appear in figures throughout this 


chapter. 


The next three sections of this chapter present the UML representation of the 
three ontologies given in the following order: 

e UML description of RequisitePro ontology 

° UML description of the SEATools ontology 

e UML description of the high level ontology 

The fourth section illustrates the description of the inter-relationships between the 
three ontologies represented using the UML notation. Different colors are used in 
representing the UML description of the three different ontologies for the purpose of 
identifying the elements of the different ontologies in a distinctive way, and to clearly 
show their interrelationships. The representation of the relationships of three ontologies 
follows the pattern established in Figure 13. The purple classes represent those classes 
within the RequisitePro ontology; the yellow classes represent those of the SEATools 


ontology and finally, the blue classes represent those of the high level software 


development ontology. 






High-level 
ontology's Classes 


RequisitePro's SEATools' 
Classes Classes 
Figure 13. Relationship Between the Classes of the Three Ontologies. 
C. UML DESCRIPTION OF REQUISITEPRO ONTOLOGY 
Classes describe concepts in the domain. For example, a concrete class of 


“Requirements” could be used to help represent later instantiated requirement objects. 


Specific requirements become instances of this class. A class can have subclasses that 
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represent concepts that are more specific than the superclass. In practical terms, 


developing an ontology includes: 


e defining classes in the ontology (as well as defining attributes of the 
classes), 

e arranging the classes in a taxonomic (subclass—superclass) hierarchy, 

e identifying and noting relationships between classes, 

e establishing and noting any constraints between classes. 


In the class diagrams, classes are represented by boxes with three parts: the name 
of the class, the attributes of the class (specified by their name, type and visibility) and 
the operations of the class (specified by name, argument list, return type and visibility). 
For the purposes of annotating our ontologies in this chapter, we do not list either the 
attributes or operations in our ontologies (these details are included in the full Protégé’ 


data base of the ontology classes). 


The following figure (Figure 14) represents the UML description of RequisitePro 
ontology. This representation consists of a package of the requirement management tool 
RequisitePro. The package contains a class diagram consisting of the main classes of the 
tool from an Extensibility User Interface (RequisitePro's Application Programming 


Interface (APD). 
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RequisitePro 





Figure 14. UML Description of RequisitePro Ontology. 


This representation of a global class diagram is intended to show the relativ e size 
and composition of the entire ontology; it will be further shown in smaller diagrams 
providing greater detail. 

1. Class Diagram: Application 

The Application object (see Figure 15) represents the main object of the 
RequisitePro Extensibility Interface that provides access to many other objects. Among 
the other objects present in this class diagram, there is Errors object that holds 
information about current and previous errors that occurred during the current 
Component Object Model (COM) session and a Projects object (a collection of opened 
Project objects). The GUI object is used by the RequisitePro application to access GUI 
dialog boxes, the Catalog object is a collection of projects accessible in RequisitePro. 


The ReqProCollection object is a generic collection object. Note that three objects 
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(Properties, Property, and ReqProCollection) exist in the class diagram and are not 


related to other objects. 


Application 


| _Cataloltem | 





Figure 15. Class Diagram: Application. 


This UML representation shows the different classes introduced in the super-class 
Application. These classes include the Projects, GUI, Properties...etc. The relationships 
between project, projects, and application are the most important classes in this diagram. 
These relationships illustrated n the ontology help achieve a degree of success in 
engineering software systems (partially determined by how easily they are developed). 
Furthermore, the ontology may standardize software projects when viewing a project as a 
container for documents subjec ted to revision management and archiving. The kind of 
standardization reduces duplication of effort, enhances interoperability and promotes 
cooperation by developing a common communication library for all software projects. 

2. Class Diagram: Package 

The Package object is an object that represents a RequisitePro package. Packages 
can contain other packages, requirements, views and documents. Package implements 
the iPackage and the iPackageable interfaces. Among the other objects present in this 
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class diagram, we have: the Views object (a collection of View objects), the View object 
(an object that represents a single view), the Documents object (a collection of Document 
objects), the Document object (an object that represents a single RequisitePro documen t), 


and Requirement object (an object that represents a RequisitePro requirement). 








S| 


RootPackage 







Requirement 
es) 






Figure 16. Class Diagram: Package. 


Figure 16 shows the different classes included in the UML class diagram 
Package. The relationships between RootPackage, Package, iPackage, and iPackageable 
Objects represent the central concepts resulting from this class diagram. The 
RootPackage object represents the container and the starting point for all user defined 
packages. The RootPackage object implements the iPackage interface. 

3. Class Diagram: Project Data 

This class diagram introduces the objects representing the Project Data. Besides 
the objects described previously in the class diagrams that preceded this one (Documents, 
Views, RootPackage Objects, etc...) there is a DiscussionLinks Object (a Collection class 
returned by a Discussion object’s DiscussionRequirements, DiscussionUsers, and 
DiscussionGroups properties). A method of the DiscussionLinks class will return a 


requirement, user, or group key based on which discussion property returned the 
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DiscussionLinks collection. The RequirementBucket object is an object-oriented 
container in which logically grouped requirements can be collected, stored, and 
transported as a single unit. It is one of the essential objects in the class diagram because 
this kind of organizer (whether for requirements collection, requirements transfer, or 
documentation) is designed to facilitate the dissemination, communication and use of 
information by multiple producers and users. Most interoperability problems are caused 
by data interpretations, and inconsistent assumptions. However, by fitting data into the 


ontology we can tackle these challenges. 








Figure 17. Class Diagram Project Data. 


Figure 17 illustrates the different classes that exist in the class diagram Project 


Data. The relationships between Views, Revisions, Discussions, Queries, and 
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Documents are the most important relations in the diagram. These relationships provide 
an ability to create links between software project artifacts and trace the established 
relationships, which fulfill the main goal of the ontology in allowing better 
understandability among all software project stakeholders in a unified framework 
applicable for any software development tool. Additionally, these are the very important 
artifacts that we want to forward/exchange and transfer between software development 
tools. 

4, Class Diagram: Project Structure 

The RequisitePro Extensibility Interface supports full project structure control, 
including creation, modification, and deletion of document types, requirement types, 
attributes, and list items. In addition, the full control of project security allows users to 
define groups, users, and permissions for all objects. The Extensibility Interface allows 


users to open multiple projects at one time. 
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Figure 18. Class Diagram: Project Structure. 


Figure 18 illustrates the different classes that exist in the class diagram Project. 
The relationships between the objects emerge from this class diagram. A categorization 
of the project is very important in the ontology because it allows the organization and the 
traceability of requirement details in order to ensure the proper resources are committed 
to the project during the requirements development phase. Attributes provide a means to 
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define different types of requirements by establishing information relationships between 
multiple documents, assigning attributes to the information, such as task assignment, and 
priority and status. All requirements are not created equal nor can it be expected that all 
requirements have the same attributes — the “attributes” classes allow us to define the key 
attributes of a type of requirement in a project. The project structure as viewed by 
RequisitePro is very important from an interoperability standpoint. 

5, Class Diagram: Project Security 

The Project Security class diagram shows the different objects related to the way 
in which RequisitePro establishes and maintains the security features of a pr oject (who 
can modify what, and when). These objects include the Users object (a collection of all 
User objects for a given project), the User object (an object that represents an authorized 
RequisitePro user), the Groups object (a collection of Group objects), the Group object 
(an object that represents a RequisitePro security group, the Permissions object (a 
collection class containing individual permission objects), and finally the Permission 
object (an object that holds information about a given group’s permissions for attribute, 


document type, list item, or requirement type data). 
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Figure 19. Class Diagram: Project Security. 


This figure represents the different classes that provide aspects of Project 
Security. These classes show the different parts involved in establishing the security and 
permissions framework within RequisitePro such as “groups” and “users”, as well as 
“permissions.” 

6. Class Diagram: Requirements 

The Requirements object is a collection of Requirement objects, (an object that 
represents a RequisitePro requirement). These in turn consist of Revisions, Attributes 


(AttValues), and Relationships. 
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Figure 20. Class Diagram: Requirements. 


Figure 20 represents the different classes that exist in the class dia gram 
Requirements and represent its subclasses such as Revisions, Attribute values, and 
Relationships. RequisitePro is a requirement tool and its most important artifact is 
requirements. Moreover, this class diagram gives the ability to get, change, verify, add, 


and delete requirements. 


Since one of the goals of the ontology is to provide interoperability between 
different software development tools, establishing a framework for reviewing 


requirements change and establishing appropriate relationships is essential and must be 
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accounted for in the ontology. Moreover, the ontology will provide opportunities for 


users to compare the vocabulary of different tools for better results. 


D. UML DESCRIPTION OF THE SEATOOLS ONTOLOGY 

We used the “Together” software to reverse-engineer the SEATools source code 
and obtained the UML class diagrams shown in Figure 21. This is just a subset of the 
overall class diagram for SEATools. The major structure of the SEATools ontology as 
presented in its UML Description consists of four Packages (PSDL, GraphEditor, 
PSDLBuilder, CapsMain) that divide and organize the SEATools model in much the 
same way that directories organize file systems. Each package corresponds to a subset of 


the model and contains, classes, as well as their relationships. 


Decomposition into packages is not the basis for a functional decomposition; each 
package is a grouping of elements according to purely logical criteria generated from the 
SEATools source code. The four packages are themselves encapsulated into the 
SEATools package as shown in Figure 21. This representation of SEATools encloses 
four sub-Packages containing different class diagrams accounted for in building the 
SEATools Ontology. Figure 21 is intended to show the relative size and composit ion of 
the entire SEATools ontology and will be further illustrated in smaller diagrams showing 


more detail in the following sections. 


The most important point to glean from Figure 21 is that each package has a 
specific purpose. For instance, the package Prototype System Description Language 
(PSDL) provides a uniform conceptual framework and high-level system description. 
The GraphEditor package allows the user to interactively create and modify PSDL 
graphs. The CapsMain package presents the basics of the SEATools development 


environment. 
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SEA Tools 


GraphEditor 





Figure 21. UML Description of the SEATools Ontology 
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1. The PSDL Package 

The PSDL Package contains various parts each of which comprises the 
components of a PSDL Graph (consisting of Vertices, Edges, etc...). Dataflow 
represents discrete transactions while PSDL Timers (a software stop watch), and others 
such as timer ops (for invoking a text window to view or edit the operator’s timer 
operations) represent the timing operations and constraints in a PSDL Graph. Output 
Guards (a feature for invoking a text window to view or edit the operator’s output guard) 
are used to selectively suppress outputs from operators. Exception Guards (a feature for 
invoking a text window to view or edit the operator’s exception guards) are also 
conditions that are evaluated when exception data streams are created. Both of these help 


to implement real-time timing requirements in a software system. 





Figure 22. The PSDL Package. 
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Figure 22 shows the PSDL Package containing different classes and a data flow 
component class diagram. The prototype is the most important part of SEATools, and 
PSDL is the powerful artifact behind prototyping. PSDL manages dataflow components 
(edges and vertices). PSDL is designed for specifying hard real-time systems. It has a 
rich set of timing specification features and offers a common baseline from which users 
and requirements engineers describe requirements. The formalism of PSDL descriptions 
of the prototype are precise and unambiguous and promote better interoperability and 
understandability. The data flow diagram augmented with control and timing constraint 
and PSDL file (together with timing constraint information) allow the user to model the 
different aspects of the prototype consistent with the requirements. Moreover, 
information from the prototypes (data flow diagrams) will be used by other software 
development tools via the ontology. Finally, it is worth saying that this part of the 
ontology gives us access to the prototype. 

2. The Graph Editor Package 

The Graphic Editor is one component of the SEATools user interfaces. It allows 
the interaction with other SEATools processes, supplies an interface with other software 


tools, and allows a user to manipulate PSDL graphs. 
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GraphEditor 


VertexProprieties EdgeProprieties 


Figure 23. The Graph Editor Package. 


The Graph Editor Package contains two classes: Vertex Proprieties class and 
Edge Proprieties Class. These two classes are among the most important classes of the 
ontology since they specify the key properties of the two major components (vertices and 
edges) of a PSDL prototype. These components tend to provide concise and meaningful 
implementation of any requirement presented by the user. They may be translated to 
other tools/prototypes that implement such requirements differently. Moreover, the 
graphical editor is used to draw dataflow diagrams annotated with nonprocedural control 


constraints as part of the specification of a hierarchically structured prototype. 
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3. The PSDL Builder Package 
The PSDL Builder package is the third sub-package in the SEATools ontology. It 
encapsulates the main classes involved in building a PSDL prototype. The classes are as 


follows: PSDLBuilderConstant, Token, and PSDLBuilder. 






PSDLBuilder 


Figure 24. The PSDL Builder Package. 


This Package contains a PSDL Builder class diagram. It shows three kinds of 
relationships existing between the classes. The diagram illustrates the relationship 
between PsdlBuilder class and PsdlBuilderConstant class. The PsdlBuilder class is 
associated uni-directionally to the Token class. Note also that the latter class presents 
two self-delegations. The class PSDL Builder allows the development of the PSDL 


model; the class “token” provides Ada symbols that are reserved symbols used by the 


82 


compiler for performing operations and calculations. Again different techniques are used 
in other software development tools, and by fitting these essential features (together with 
other techniques used by other tools for similar purposes) into our ontology, 
interoperability will be achieved and the software development tools will be able to trade 
and properly translate similar information. 

4. The Caps Main Package 

The Caps Main Package describes various classes related to prototypes introduced 
through the Caps Main Window. This sub-package introduces the classes 
(SchedulePrototype, TranslatePrototype, CompilePrototype, ExecutePrototype) needed to 
transform the prototype from a simple graphical representation of the system into an 
executable software prototype. The TranslatePrototype class translates the prototype 
through a translator designed to generate code that binds components that have either 
been extracted from the software base or have been custom-built. The SchedulePrototype 
class invokes a real-time scheduler that generates two types of schedules depending on 
the priority and type of the prototype'’s timing criteria and constraints. The 
CompilePrototype and the ExecutePrototype classes attempt to compile the prototype 
(i.e., Ada modules and programs) and to run an executable prototype system. The 
execution support system consists of a translator, a scheduler and a compiler to facilitate 


the testing of the prototypes. 
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Figure 25. The Caps Main Package. 


Figure 25 shows the class diagram of the Caps Main Window. These classes 
address the problem of how to produce an executable prototype summarizing all the 
requirements. Different software development tools may generate distributed and 
heterogeneous software projects that may work together via multiple communication 


links and protocols. The prototyping classes created and used in the CapsMain Package 
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are important to the ontology so that exernal tools can create, modify and use reliable, 


executable prototypes created in SEATools. 


E. UML DESCRIPTION OF THE HIGH LEVEL ONTOLOGY 

The high level Software Development Tool Ontology was constructed to be 
applicable (and extensible) to any software development tool and includes classes that are 
often found in software project development. Figure 26 shows the entire High Level 


Ontology; however, the ontology will be further illustrated in additional diagrams that 


better show the relationships between all these classes. 
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Figure 26. UML Description of the High Level Ontology. 


Essentially there are three major parts to the ontology: artifacts (dealing with all 
objects developed in a software project), actors (stakeholders and teams involved in a 
software project), and activities (required throughout the life-cycle of a software project 
from management to communication). These main parts will be introduced in greater 
detail in the next sections. 

1. Class Diagram: Artifact 

The Class diagram Artifact expresses, in a general way, the static structure of the 


artifacts that a software development system (software project components and 
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characteristics) might produce in terms of classes and relationships between those classes. 
Just as a class describes a set of objects, an association describes a set of relationships; 
objects are class instances, and links are association instances. This class diagram does 
not express anything specific about the links of a given object, but it describes, in an 


abstract way, the potential links from an object to other objects. 





Figure 27. Class Diagram Artifact. 


” 


Figure 27 shows the different classes introduced in the super-class “Artifact. 
These classes include the documentation, links -dependency-traceability, ...etc. This is 
not intended to be an all inclusive list of artifacts; this diagram can be extended as new 
artifacts (from other tools) are integrated into the ontology. In including these artifacts 
(with their structures) in the ontology we are likely to integrate an important section of 
knowledge shared by various software development tools (expressed in different words). 
Artifacts are the main things we want to trade between tools, that is what makes them so 


important. 
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2. Class Diagram: Activity 

Successful software development tool use requires actively managing different 
interactions (activities). All the objects derived from the Activity class are integral parts 
of the software development tools. Any “activity” in a software development tool 
environment is undertaken with the aim of directly or indirectly producing (or improving) 


a software development artifact. 





Figure 28. Class Diagram Activity. 


This class diagram shows many of the common “activities” represented by classes 
that can be used in software project development. This is not intended to be an all 
inclusive list of activities; this diagram can be extended as new activities (from other 


tools) are integrated into the ontology. As a result, the integration of these activities into 
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the ontology will facilitate interoperability with the different tools using different 
structures. 

3. Class Diagram: Actor 

The class diagram Actor represents all the people involved in software project 
development. The structure describes Actor as a class, where the sub -classes 
(Stakeholders and team) are derived from it. Moreover, the classes developers, designers, 


and architects are themselves derived from the class stakeholders. 





Figure 29. Class Diagram Actor. 


This Class diagram shows all the classes of people (or teams of people) that may 
participate or be involved in any software project development. The main conclusion that 
would be drawn from this diagram is that the class Actor and its subclasses form the main 
group involved in any software project. By integrating them in our ontology, we make 


them explicit and we avoid confusion and ambiguity. 


F. UML DESCRIPTION OF THE INTER-RELATIONSHIPS BETWEEN 
THE THREE ONTOLOGIES 


We identified the characteristics of each individual software development tool 
that must be accounted for within the higher-level ontology. In the following class 
diagrams we introduce views as a way of illustrating the inter -relationships between the 
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two individual tool ontologies and the high-level ontology. These inter-relationship class 
diagrams form the basis for establishing interoperability between the tools using Young's 
OOMI methodology [YOUNO2]. 

1. Class Diagram: Communication 

When properly managed, a Software project usually has a communicated set of 
processes that address the daily activities of the project. As a result, all the people 
involved in any software project understand their roles and responsibilities and how they 
fit into the big picture, thus promoting the efficient use of resources. Each software 
development tool has its own way of communication, and the following diagram 
illustrates our view of the interoperability between the three ontologies (RequisitePro, 


SEATools and high level) with respect to communication. 


Figure 30 shows the interoperability among the three ontologies (RequisitePro, 
SEATools, and the high level one) at the level of communication. We view the inter - 
relationship between the three ontologies in communication as a generalization. Since 
we adopted only classes in the UML descriptions of our ontology, we assume that the 
attributes, operations, relationships and constraints defined in the superclass 


Communication are fully inherited in the subclasses. 
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CapsMainWindow 


Figure 30. Class Diagram: Communication. 


2. Class Diagram: Prototype 

One of the best ways to test the usability of a product while there is still time to 
make changes is to develop a prototype. The idea is to build a mock-up of the product, 
which simulates the look and feel of the interface and brings many of the complex 
interaction problems out. Review of the prototype enables users, pr oject managers, and 
developers to agree on how an application should look. The following class diagram 
describes our view of the inter-relationship between the three ontologies at the prototype 


level. 
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Figure 31. Class Diagram: Prototype. 


Figure 31 shows the interoperability among the three ontologies (RequisitePro, 
SEATools, and the high level one) at the Prototype level. Although, note that there is no 
matching ontology class from the RequisitePro ontology for Prototype. 


The generalization relationship expresses the fact that the elements of the 
Prototype class are also described by details of the Vertex and Edge sub-classes. The 
open arrows symbolize the navigation property of associations. Associations describe the 
network of structural relationships that exist between the different classes, and give birth 
to links between the objects that are instances of these classes. 

3. Class Diagram: Creation 

The class diagram Creation describes the inter-relationships between the three 
ontologies when dealing with the creation of any software project. The prototype is also 


considered as an archetype of a project. Therefore, its creation is also considered. 
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CompilePrototype 


ExecutePrototype 


Figure 32. Class Diagram: Creation. 


Figure 32 shows the interoperability among the three ontologies (RequisitePro, 
SEATools, and the high level one) at the Creation level. Also note that there is no 
matching ontology class from the RequisitePro ontology for Creation. We adopted the 
same view as before, and we considered the main inter-relationships as a generalization. 

4, Class Diagram: Actor 

The following diagram depicts our view toward the inter-relationships existing 


between the three ontologies generated from the superclass Actor. 


Figure 33 shows the interoperability among the three ontologies 
(RequisitePro, SEATools, and the high level one) at the Team level. Although, note that 
there is no matching ontology class from the SEATools ontology for Actor. The choice 


of “Users” as a sub-class of designers was derived from the RequisitePro structure. 
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Figure 33. Class Diagram: Actor. 


5. Class Diagram: Documentation 

The role of documentation in any project development is critical. Specifications, 
designs, business rules, inspection reports, configurations, code changes, test plans, test 
cases, bug reports, user manuals, etc. should all be documented. The following diagram 
describes one way of representing the inter -relationships between the three ontologies for 


the class Documentation. 


Figure 34 shows the interoperability among the three ontologies (RequisitePro, 
SEATools, and the high leve one) at the Documentational level. Although, note that 
there is no matching ontology class from the SEATools ontology for Documentation. 
Note that the generalization is “multiple”, and several arrows are drawn from the 


subclasses to the various superclasses. 
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Figure 34. Class Diagram: Documentation. 


6. Class Diagram: Requirements 
Requirements are the details describing an application's externally perceived 
functionality and properties. The following diagram summarizes the UML description of 


the inter-relationships between the three ontologies toward Requirements. 
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Figure 35. Class Diagram: Requirements. 


Figure 35 shows the interoperability among the three ontologies (RequisitePro, 
SEATools, and the high level one) at the Requirements level. Again, note that there is no 
matching ontology class from the SEATools ontology for Requirements. The 
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requirements of the high-level ontology represents the high level class from which 
derived the subclass RequisitePro requirements. 

7. Class Diagram: Model 

A comprehensive model integrates existing techniques and standards for 
modeling software products, processes, and people. We have analyzed the model to 
identify the key relationships that integrate the three ontologies. Our effort resulted in the 
following diagram that focuses only on the software project as a main subclass of the 


superclass model. 





Figure 36. Class Diagram: Model. 


Figure 36 shows the interoperability among the three ontologies (RequisitePro, 


SEATools, and the high level one) at the Model level. Note that there is no matching 
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ontology class from the SEATools ontology for Model. Recall that while the PSDL 
prototype is considered a “model”, it was integrated with the higher ontology through 
“Prototype”. The main point to get out from this class diagram is the generalization 
relationship that exists between model and project. 

8. Class Diagram: Security 

The security of software projects represents an essential step in assuring its 
success. The following diagram describes the inter-relationships between the three 


ontologies for security. 











Permissions 


Permission 





Figure 37. Class Diagram: Security. 


Figure 37 shows the interoperability among the three ontologies (RequisitePro, 
SEATools, and the high level one) at the Project Security level. The Permissions class 
generated by the UML description of RequisitePro ontology is considered as a subclass 
of the superclass Security generated from the UML description of the High-level 
ontology. Note that there is no matching ontology class from the SEATools ontology for 


Security. 


G. SUMMARY 
In this chapter we have presented each individual tool ontology, the high-level 
ontology, and the inter-relationships between these ontologies using UML. We 


addressed the complex issues of defining class hierarchies. However, there is no single 
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static ontology for any domain. Ontology design is a continuing, creative process. This 
Software Development Tool Ontology was developed as part of the establishment of a 
Holistic Framework for establishing interoperability of heterogeneous software 
development tools and models. Its scope is limited to those core features required for the 
software project development. The development of the ontology has taken account of 
other external ontology developments whenever possible; however, the goal was always 
to be compatible with existing ontologies where possible. This ontology will be further 
refined and extended throughout the future as new software development tools are 


integrated into the ontology. 
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VI. CONCLUSIONS 


Software development tools are heterogeneous software systems that present 
many challenges in interoperability. These challenges stem from complex issues on the 
choice of the types of information that might be able to be captured and the relevant 
knowledge structure that needs to be presented in an optimal way. We observe that 
disparate backgrounds, tools, and techniques are a major barrier to effective 
communication among people, organizations, and/or software systems. We show how 
the development and implementation of an explicit account of a shared understanding 
(ie. an “ontology”’) in the software development tools area, can improve such 
communication, which in turn, can give rise to greater reuse and sharing, interoperability, 


and more reliable software. 


Among the foundation and related works that formed a basis for this ontology, 
Young [YOUNO2] proposed an _ object-oriented methodology for establishing 
interoperability between heterogeneous systems that allows interaction between their 
different objects. He proposed resolving the differences between existing systems via the 
establishment of a Federation Interoperability Object Model (FIOM). The establishmen t 
of such object federation between existing process model together with the integration of 
the federation with the extended evolution model, will generate an availability of inputs 


and outputs between subordinate models. 


The issues and challenges posed by the heterogeneity of software development 
tools were addressed by identifying and defining the essential characteristics of two 
software engineering tools: a Requirement's Engineering Tool (Rational Software 
Corporation's RequisitePro), and a software prototyping tool (Software Engineering 
Automation Tools (SEATools)), developed by the NPS’s software engineering group. 
The approach undertaken was to construct a “pilot” ontology that might be extended in 
the future to include other software development tools. The essential idea was to capture 
the commonalities between these two tools and express them in such a way that would 


promote interoperability and enhanced communication. 
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The approach to this portion of the research was to analyze the structure, in puts, 
and outputs of the two individual tools, perform a domain analysis (of this subset of 
tools) and produce a feature model of that domain. Following from this analysis was the 
task of identifying the characteristics of each individual software develop ment tool that 


must be accounted for within higher-level ontology. 


The ontology that was generated in this research was influenced by the future goal 
and intended use of the ontology. In this case, the intended use was to establish 
interoperability between all software development tools (with a near-term goal of 
establishing interoperability between two specific tools). These two tools were not 
chosen arbitrarily. The future purpose of the ontology biases the choice of the particular 
set of features that are analyzed. The future purpose biases the organization of the 
domain of interest by highlighting commonalities and resemblances needed for the given 
purpose. 

The choice of a proper ontology for the software development tools was very 
important factor in accomplishing the task of interoperability building and structuring, far 
beyond the issue of the representation of the inventory of the software development tools’ 
features. All the following factors were taken into account in developing the 
methodology adopted in the development of the ontology: 

° The Role of the Ontology 

The major role of the software development tool Ontology is to act as a 
communication medium between different software development tools and people 
(including users, developers and all the stakeholders) across any software project 
development environment. 

° Scope 

Considerable time and effort was devoted to deciding the scope and boundaries 
for the software development tool ontology. We began by brainstorming to identify as 
many potentially important features as possible. This produced a totally unstructured list 
of words and phrases corresponding to a wide variety of features relevant to software 
development tools. These were then grouped into various areas and functionalities such 
that there was more similarity in meaning and a need to refer to terms within an area than 
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between different areas, e.g. Tool, Activity, Actor, and Artifacts. Within each work area, 
the terms were assigned priorities indicating the importance of including them in the 
ontology. For each feature, terms were chosen depending on the task assigned to each 
feature, and definitions given. 

° Choosing Features and Terms 

The terms in the software development tool Ontology have been chosen as far as 
possible to match the natural use of English words by people managing software projects 
and using software development tools. This is often difficult. For a term to be used in 
the ontology, the meanings were specifically defined. 

° Specification of the Ontology 

We defined the classes and the class hierarchy using two approaches (top-down 


and bottom-up approaches) 


e A top-down development process that starts with the definition of 
the most general concepts in the domain and _ subsequent 
specialization of the concepts. For example, we started by creating 
classes for the general concepts of each super-class such as 
“requirements.” Then we specialized the super -class by creating 
some of its subclasses. 


e A bottom-up development process that starts with the definition of 
the most specific classes, the leaves of the hierarchy, with 
subsequent grouping of these classes into more general concepts. 
For example, we start by defining classes “sort” and “filter.” We 
then create a common super -class for these two classes-organize- 
which in turn is a subclass of “activity.” 


Figure 38 below shows the representation of the Protégé representation of the 
high level Ontology. The three main classes (Artifacts, Actor, and Activity are found at 
the top level of the ontology). 
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Figure 38. The Different Levels of the Software Development Tool Features. 


Actor, Activity, Artifact are the more general features a form the top level. 
Security, risk, and safety are some of the most specific classes in the hierarchy and thus 


are at the bottom level. 


The methodology we used to arrive at the software development tool ontology is 
as important as the ontology itself and represents one of the major accomplishments in 
this Thesis. While the ontology will determine whether the interoperability ontology for 
the two software development tools (Rational RequisitePro) and Software Engineering 


Automation Tools (SEATools) is appropriate, the methodology will ensure that the 
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ontology can be later extended with the inclusion of additional tools. The Software 
Development Tool Ontology should not be considered static; it is an evolving definition 
of terms. It will be further refined and extended as needed to integrate other software 
development tools into the ontology. The ontology will be of interest to whoever is 
interested in mproving the interoperability and improve the communication between 


software project stakeholders 


The contributions presented in this thesis are the following: 


e Development of a methodology based on feature modeling to identify the 


essential characteristics of software development tools applicable to other 
software development tools. 


e The building of a “pilot” Ontology for the domain of software 
development tools using “Protégé 2000”. 


e Identification of the commonalities between two specific development 
tools’ (Requisite Pro an SEATools). 


Finally, it is important to note that there is no single static ontology for the 
software development tool domain nor did we attempt to define one. The ideas that we 
present here are the ones that we found useful in our own ontology-development 
experience leading to the beginnings of an ontology that may one day establish the 


interoperability of all software development tools. 
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APPENDIX A. REQUISITEPRO FEATURE TREE 


The feature diagrams for the following tools: RequisitePro requirements 
management tool and the Software Engineering Automation Tools (SEATools) serve as 
an exploitation of the approach of feature modeling in a constructive way to show the 
eventual interoperability between these two software engineering tools. The choice of 
these tools was tailored by the fact that this subset includes both a commercial and 
research tool and represents substantial elements of the software development process 


itself. The feature tree is a representation of the essential features for each software 


development tool, part of this research. 


In Figure 39, the RequisitePro feature tree represents the entire tools’ features. 


This tree will be further showed in more detailed subsets in the following parts. 
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Figure 39. RequisitePro Feature Tree. 
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Figure 40. High-Level RequisitePro -Subset of the Feature Tree. 


Figure 40 shows the subset of RequisitePro representing the three parent features 
that will be themselves divided into some other features. The figure shows that these 


main high-level are considered mandatory features according to their essential roles. 
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Figure 41. Project Management RequisitePro Feature Tree’s Subset. 


Figure 41 notes the existence of features showing the possibility allowed by the 
tool to set up a new project, or review project, or set up project and review at the same 
time. However, there are five optional features (set up new project, project revision, 
delete project, manual or automatic revision of projects). The three other features are 


mandatory ones. 
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Figure 42. Teams Management RequisitePro Feature Tree’s Subset. 


Figure 42 shows the detailed subset of the RequisitePro feature tree illustrating 


the essential features generated by the teams’ management feature. 
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Figure 43. Documents Management RequisitePro Feature Tree’s Subset. 


Figure 43 illustrates the detailed subset of the RequisitePro feature tree 


representing the essential features generated by the documents’ management feature. 
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Figure 44. Control Requirements Subset. 


Figure 44 shows the detailed subset of the RequisitePro feature tree illustrating 
the control requirements essential features generated from the requirement analysis 


feature provided by the tool. 
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Figure 45. Control Requirements Subset (Cont). 


Figure 45 shows the rest of the detailed subset of the RequisitePro feature tree 
illustrating the control requirements essential features generated from the requirement 


analysis feature provided by the tool. 
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Figure 46. Report Generation RequisitePro Feature Tree’s Subset. 


The detailed subset of the RequisitePro feature tree illustrating the Report 
Generation essential features generated from the requirement analysis feature provided by 


the tool as shown in Figure 46. 
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Figure 47. Treacability RequisitePro Feature Tree’s Subset. 


This tree illustrates the children features of one of the potential features provided 
by the requirement management tool (RequisitePro). The tool allows either the 
mandatory set up links between the requirements or the mandatory cleared suspect links 
or both together. However, the previous actions might be accomplished with an optional 


choice (manual or automatic) of one action among two. 
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Figure 48. Treacability RequisitePro Feature Tree’s Subset (Cont). 


Figure 48 shows the rest of the detailed subset of the RequisitePro feature tree 
illustrating the treacability of the requirements feature generated from the requirement 


analysis feature provided by the tool. 
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Figure 49. Non-Functional Features as RequisitePro Feature Tree’s Subset. 


Figure 49 illustrates a collection of a non-functional mandatory features provid ed 


by the RequisitePro tool. 
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APPENDIX B. SEATOOLS FEATURE TREE 


Appendix B presents the entire feature tree of the Software Engineering 
Automation tools (SEATools). This feature tree is presented in detailed subsets. This 


feature model defines a hierarchical structure over the set of features of the tool. 


Figure 24 shows an entire feature tree representing the essential features of the 
software engineering tool for developing prototypes of real-time systems. SEATools is 
an integrated collection of tools that are linked together to form a software development 


environment. 
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Figure 50. SEATools’s Feature Tree. 
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Figure 51. High-Level SEATools’ -Subset of the Feature Tree. 


Figure 51 shows the subset of SEAtools representing the three parent features that 
will be themselves divided into other features. The figure shows that these main high - 


level features are considered mandatory features according to their essential roles. 
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Figure 52. Manage Prototype Feature Tree’s Subset. 


Figure 52 notes the existence of features showing the possibility allowed by the 
tool to develop prototype or analyze requirements through the evolutionary prototype or 
both functionalities at the same time. The four features are mandatory and also divided to 


some other low level features. 
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Figure 53. Develop Systems Feature Tree’s Subset. 


Figure 53 shows the features derived from the parent feature “develop systems”. 
These features are further differentiated by three categories: essential, very useful, and 
useful. As an illustration, compilers, operating systems, assemblers, and programming 
languages are essential tools or features. Editors and libraries are very useful tools or 


features. 
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Figure 54. Essential Feature Tree’s Subset. 


Figure 54 shows the subset “essential” of the develop systems’ feature tree. It 


shows the four mandatory features or tools of the SEATools: Compilers, operating 


systems, assemblers, and programming languages. 
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Figure 55. Very Useful Feature Tree’s Subset. 


The subset “very useful” of the develop systems’ feature tree shows the two 
mandatory features or tools of the SEATools: Libraries, and editors. Meanwhile, the 
library feature is further divided into two mandatory features: library of reused code and 


other libraries. 
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Figure 56. Develop Systems Feature Tree’s Subset (Con’t.) 


Figure 56 shows another branch from the features derived from the parent 
“develop systems”. The diagram shows the essential features tailored to project control. 


As it is shown in the graph, these features are mandatory and essential. 
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Figure 57. Build Prototype Feature Tree’s Subset. 


Figure 57 shows the features derived from the parent “build prototype”. The 
diagram shows the essential features tailored to build a prototype for a software project. 


As it is shown in the graph, these features are mandatory and essential. 
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Figure 58. Automatically Generate Code Feature Tree’s Subset. 


Figure 58 shows the features derived from the parent “build prototype”. This 
shows the essential features tailored to automatically generate code. As it is shown in the 


figure, only two features are optional to use to automatically generate code. 


126 










automatically 
generate code 


execution 
support 
systems 









execute 
system 






translator compiler 





O O 


Figure 59. Automatically Generate Code Feature Tree’s Subset (Cont). 


Figure 59 is another part of the features generated from “automatically generate 


code”. 
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Figure 60. Model Editor Feature Tree’s Subset. 


Figure 60 shows the features derived from the parent “build prototype’. The 


diagram shows the essential features tailored to “model editor.” 
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Figure 61. User Interface Feature Tree’s Subset. 


Figure 61 shows the features of the third high-level feature of the SEATools (user 


interface). It shows the essential features derived from the parent. 
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Figure 62. Prototype Feature Tree’s Subset. 


Figure 62 shows the essential features that may be used when working with 
prototypes. SEATools allows the choice of prototypes, the creation of prototypes, the 


modification, and the retrieve of prototypes. 
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Figure 63. Edit Feature Tree’s Subset. 


Figure 63 illustrates the different features derived from the feature “edit”. These 
features are all (by chance) “mandatory-features”. Notice that the user has the ability to 
"edit" numerous artifacts with SEATools as shown in the second level of this diagram. In 
the fourth level, the feature “other text editor” is divided into two mandatory features, but 


their choice is alternative. 
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APPENDIX C. CLASS HIERARCHY FOR ONTOLOG Y- 
REQUISITEPRO PROJECT 


In this Appendix we illustrate a selective subset of the RequisitePro ontology 
generated by Protégé-2000. This appendix starts by introducing all the classes that exist 
in the RequisitePro ontology in class hierarchy tree. This hierarchy is automatically 
generated by Protégé-2000. Following the hierarchy is a Protégé generated print-out of 
the specifics of the important classes that we judged most useful to our interoperability 
ontology. These classes are: Application, Projects, Project, Requirements, Requirement, 


AttrValues, AttrValue, Relationships, Relationship, Documents and Document. 
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Application 
= Projects 


= GUI 
= Errors 


Project 


RootPackage 
= 1Packageable 
= Package 
= 1Package 
Requirements 
= Revisions 
= Revision 
= Requirement 
= AttrValues 
= AttrValue 
= ListItem Values 


e = ListItem Value 


= Revisions 
= Revision 
= Relationships 
= Relationship 
Discussions 
= Discussion 
= Responses 
= Response 
= DiscussionLinks 
RelatedProjectContexts 
= RelatedProjectContext 


= Documents 
= Document 
= Reports 
= Queries 
= Query 
= Views 
= View 
= RequirementBucket 
= Groups 
= Group 
= Permissions 
= Permission 
= Users 
= User 
= DocTypes 
= DocType 
= ReqTypes 
= ReqType 
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Attrs 


Attr 


ListItems 


ListItem 


= ServerInformation 
= Catalog 
= CatalogItem 
o Properties 
= Property 
ReqProCollection 
Connector 
Context 
CustomType 
CustomTypes 
EMail 
Roseltem 
Roseltems 


0000000 0 


CLASS APPLICATION 
Template Slots 


Cardinality 


Event Action(eEventType As enumEventTypes, 
eObjectType As enumInterfaceldentifiers, sGUID As 
String, vEventData, eEventDataType As 
enumEventDataTypes, eEventSubType As 
enumEventSubTypes, sTimestamp As String) Member 
of ReqPro40.Application 


> 


Action ny 


Function LockProject(vProjLookupValue, 
[eProjLookuptype As enumProjectLookups]) As String 
Member of ReqPro40.Application Locks a specific 
open project. 


LockProject 


Property ProjectLockCount(vProjLoo kupValue, 
[eProjLookuptype As enumProjectLookups]) As Long 
read-only Member of ReqPro40.Application Returns 
the number of ouststanding locks on a project object. 


Property PWD As String Member of 
ReqPro40.Application Sets a default password 


ProjectLockCount 





PWD 


Property IsServerOpen As Boolean read-only 
IsServerOpen | Member of ReqPro40.Application Determines whether 
the server is running 


Boolean 


Sub PublishAction(eEventType As enumEventTypes, 
eObjectType As enumInterfaceldentifiers, sGUID As 
String, vEventData, eEventDataType As 
enumEventDataTypes, eEventSubType As 
enumEventSubTypes) Member of 


PublishAction 


ReqPro40.Application 


Property PersonalCatalog As Catalog read-only 
PersonalCatalog | Member of ReqPro40.Application Returns the local 
Catalog object 


Property Version As String read-only Member of 
Version| ReqPro40.Application Returns the version of the 
application 


n n n n n n 
= = = = = = 
o. s. s. s. a. a. 
5 5 5 5 5 5 
ga gq aq ir) VC) Vr) 
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Template Slots 


Property CustomTypes As CustomTypes _ read-only 
oCustomTypes | Member of ReqPro40.Application Reserved for future 
use. 


Function CompareVersionNumber(sNumber! As String, 
CompareVersionNumber | sNumber2 As String) Member of 
ReqPro40.Application Compares version numbers 


Property VersionRev As Long read-only Member of 
VersionRev| ReqPro40.Application Returns the version revision 
number 


Property VersionMajor As Long read-only Member 
VersionMajor| of ReqPro40.Application Returns the major version 
number of the application 


Property VersionMinor As Long read-only Member 
VersionMinor| of ReqPro40.Application Returns the minor version 
number of the application 





unction OpenProjectProperties(vOpenProjOption Value, 
[eOpenProjOptionType As enumOpenProjectOptions = 

OpenProjectProperties | eOpenProjOpt_RQSFile]) As Properties Member of 
ReqPro40.Application Opens a RequisitePro project 
and returns its properties 


Property PersonalCatalogItem(vCatLookupValue, 
[eCatLookupType As enumCatalogLookups = 
PersonalCatalogltem | eCatLookup_Name]) As CatalogItem read-only 
Member of ReqPro40.Application Returns the 
specified catalog item from the Local catalog collection 


Property IsProjectLocked(vProjLookupValue, 
[eProjLookuptype As enumProjectLookups]) As 

IsProjectLocked| Boolean read-only Member of 
ReqPro40.Application Determines if a specific project 
has any outstanding locks. 


Sub ExtendedHelp(sProduct As String, sSubTool As 
String, sItem As String, sOperation As String, sQuery 
As String) Member of ReqPro40.Application 
Launches Rational Extended Help 


Sub UnlockProject(sGUID As String, 
vProjLookupValue, [eProjLookuptype As 

UnlockProject | enumProjectLookups]) Member of 
ReqPro40.Application Removes a lock from a specific 
project. 


ExtendedHelp 





Property AreProjectsLocked As Boolean read-only 
Member of ReqPro40.Application 


CioseSeruer Sub CloseServer() Member of ReqPro40.Application Angy 
Reserved 
' Property EventRaiseEnabled As Boolean Member of 
Even Raielnabied ReaPro40.Application Returns or sets whether the eniecal 
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Template Slots 


Documentation Cardinality 
server raises server events a 


Function GetCurrentProjectUsers(sRQSPath As String) Stri 
As Properties Member of ReqPro40.Application ee 


Property IsValidLock(sGUID As String, 
String 
Template Slots 


vProjLookupValue, [eProjLookuptype As 

IsValidLock| enumProjectLookups]) As Boolean — read-only 

Member of ReqPro40.Application Returns whether the 
supplied GUID represents a valid lock. 

Property VersionMinor As Long read-only Member 

VersionMinor| of ReqPro40.Application Returns the minor version 

number of the application 


Ciwccsaseer Sub CloseServer() Member of ReqPro40.Application 
Reserved 


Property VersionRev As Long read-only Member of 
VersionRev | ReqPro40.Application Returns the version revision 
number 





Slot: iame 













GetCurrentProjectUsers 















CLASS PROJECTS 


Cardinality 






0 


ae 


String 


> 


i=) 
So 


i=) 


=) 


String 


Function CompareVersionNumber(sNumber! As 
CompareVersionNumber | String, sNumber2 As String) Member of 
ReqPro40.Application Compares version numbers 


io) 


a a a a a a a a 


String 


Property PersonalCatalog As Catalog _ read-only 
PersonalCatalog | Member of ReqPro40.Application Returns the local 
Catalog object 


String 


Property IsServerOpen As Boolean _ read-only 
IsServerOpen| Member of ReqPro40.Application Determines 
whether the server is running 


Boolean 


Property ProjectLockCount(vProjLookupValue, 
[eProjLookuptype As enumProjectLookups]) As Long 
read-only Member of ReqPro40.Application Returns 
the number of ouststanding locks on a project object. 


jo) 


ProjectLockCount String 





Sub UnlockProject(sGUID As String, 
vProjLookupValue, [eProjLookuptype As 

UnlockProject | enumProjectLookups]) Member of 
ReqPro40.Application Removes a lock from a specific 
project. 


io) 


String 





Event Action(eEventType As enumEventTypes, 
eObjectType As enumInterfacelde ntifiers, sGUID As 
String, vEventData, eEventDataType As 


jo) 


Action Any 


enumEventDataTypes, eEventSubType As 
enumEventSubTypes, sTimestamp As String) 
Member of ReqPro40.Application 
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Template Slots 


Cardinality 


Sub PublishAction(eEventType As enumEventTypes, 
eObjectType As enumInterfaceldentifiers, sGUID As 
String, vEventData, eEventDataType As 


PublishAction String 


enumEventDataTypes, eEventSubType As 
enumEventSubTypes) Member of 
ReqPro40.Application 





unction OpenProjectProperties(vOpenProjOption Value, 







[eOpenProjOptionType As enumOpenProjectOptions = 
OpenProjectProperties | eOpenProjOpt_RQSFile]) As Properties Member of 
ReqPro40.Application Opens a RequisitePro project 


ae 


String 


ae 


S S S = S S S 
a a 


and returns its properties 


Property Item(vViewLookupValue, [eViewLookupType 
As enumViewLookups = eViewLookup_Key]) As View 
read-only Default member of ReqPro40.Views 
Returns the specified View 


ae 


Item Any 











Property VersionMajor As Long read-only Member 
VersionMajor| of ReqPro40.Application Returns the major version 
number of the application 


String 


Property IsProjectLocked(vProjLookupValue, 

[eProjLookuptype As enumProjectLookups]) As 
IsProjectLocked| Boolean read-only Member of 

ReqPro40.Application Determines if a specific project 


ae 


Boolean 


has any outstanding locks. 


Function LockProject(vProjLookupValue, 


[eProjLookuptype As enumProjectLookups]) As String 


LockProject String 


Member of ReqPro40.Application Locks a specific 
open project. 





Property AreProjectsLocked As Boolean read-only 
Member of ReqPro40.Application 


AreProjectsLocked Boolean | 0:1 












Property Count As Long read-only Member of 
Count| ReqPro40.Views Returns the number of View objects 
in the collection 


: Function GetCurrentProjectUsers(sRQSPath As String) : 
P t 0:1 
Sen earenelrareet sere As Properties Member of ReqPro40.Application Sune 


Property PersonalCatalogItem(vCatLookup Value, 
[eCatLookupType As enumCatalogLookups = 
PersonalCatalogltem | eCatLookup_Name]) As CatalogItem read-only String 0:1 
Member of ReqPro40.Application Returns the 
specified catalog item from the Local catalog collection 
Property PWD As String Member of : . 
ep ReqPro40.Application Sets a default password ates ee 
Property EventRaiseEnabled As Boolean Member of 
EventRaiseEnabled | ReqPro40.Application Returns or sets whether the Boolean | 0:1 
server raises server events 


IsModified | Property IsModified As Boolean read-only Member 
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Template Slots 


of ReqPro40.Views Returns whether any of the Views 
in the collection have been modified 


Refresh | Sub Refresh() Member of ReqPro40. View 


y : 
Property Version As String read-only Member of 
Version| ReqPro40.Application Returns the version of the String | 0:1 
application 
Property CustomTypes As CustomT ypes _ read-only 
oCustomTypes | Member of ReqPro40.Application Reserved for future | String | 0:1 
use. 
Sub Revert([bRevertAll As Boolean = False]) 
Revert| Member of ReqPro40.Views Restores objects to their | Boolean | 0:1 
state when originally created 
Seni Sub Save() Member of ReqPro40.Views Save all a 0:1 
@V¢) Views that have changed to the database ny : 


Property IsValidLock(sGUID As String, 
vProjLookupValue, [eProjLookuptype As 

IsValidLock| enumProjectLookups]) As Boolean _ read-only 
Member of ReqPro40.Application Returns whether 
the supplied GUID represents a valid lock. 







Sub ExtendedHelp(sProduct As String, sSubTool As 
String, sItem As String, sOperation As String, sQuery 


Pcuaa ely As String) Member of ReqPro40.Application 
Launches Rational Extended Help 
CLASS PROJECT 
Template Slots 
Slot nan e 


Property PermissionsForReqName(IReqTypeKey 
PermissionsForReqName | As Long) As enumPermissions — read-only 
Member of ReqPro40.Project 


Property RQSFilepath As String read-only 
RQSFilepath | Member of ReqPro40.Project Returns the 
pathname of the .rqs file 


Sub ExtendedHelp(sProduct As String, sSubTool 


As String, sItem As String, sOperation As String, 

ExtendedHelp | sQuery As String) Member of 
ReqPro40.Application Launches Rational 
Extended Help 


Property IsCurrentUserAdmin As Boolean 
read-only Member of ReqPro40.Project 
Returns whether the current user has 
administrative permissions 


IsCurrentUserAdmin 


Function ChangeLoggedInUser(v Value, 


Ghangelcgzcealiser [eUserLookup As enumUserLookups = 
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Template Slots 


Cardinality 


eUserLookups_Key], [vValue2]) As Boolean 
Member of ReqPro40.Project Changes the user 
logged into the project. 


Property IsLocked As Boolean _ read-only 
IsLocked | Member of ReqPro40.Project Returns a value 
indicating whether or not the Project is locked. 





Property VersionRev As Long _ read-only 
VersionRev | Member of ReqPro40.Application Returns the 
version revision number 








Function Query Validate(eQueryBaseType As 
enumQueryBaseTypes, eQueryFormat As 
enumQueryFormats, sQueryString As String, 
[oQueryDef As Object]) As Long Member of 
ReqPro40.Project Checks the specified query 
for correct syntax 


Sub Save() Member of ReqPro40.Views Save 
all Views that have changed to the database 
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QueryValidate 





Save 


Property LogRelationshipRevisions As Boolean 
LogRelationshipRevisions | Member of ReqPro40.Project Returns or sets 
whether relationships are logged in Revisions 


Function 
GetRequirementsCount(vReqsLookupValue, 
[eReqsLookupType As 

GetRequirementsCount | enumRequirementsLookups = 
eReqsLookup_ReqTypeKey]) As Long 
Member of ReqPro40.Project Returns the count 
of records returned by a query. 


Refresh | Sub Refresh) Member of ReqPro40.View 
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Property SequenceKey As Long _ read-only 







Member of ReqPro40.Project Returns the 
sequence key for the project. The sequence key is | String 
an incrementing number assigned as a project is 


SequenceKey 


opened. 


Property LockCount As Long _ read-only 
LockCount | Member of ReqPro40.Project Returns the 
number of outstanding locks against the Project. 





Property UserGroupKey As Long _ read-only 
UserGroupKey | Member of ReqPro40.Project Returns the group 
of the current user 


: Function ValidPackage_(IKey As Long) As 
ValidP aokage Boolean Member of ReqPro40.Project paper 


Property NewReqProCollection As 
ReqProCollection read-only Member of 


String 





NewReqProCollection 


ReqPro40.Project Returns a new 
ReqProCollection object. 
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Template Slots 


Property IsInDB(IKey As Long, eInterfaceID As 
enumInterfaceldentifiers, [sVersionNumber As 

IsInDB | String]) As Boolean read-only Member of Boolean 
ReqPro40.Project Returns whether the specified 
object is in the database 


Property IsProjectLocked(vProjLookupValue, 
[eProjLookuptype As enumProjectLookups]) As 

IsProjectLocked | Boolean read-only Member of 
ReqPro40.Application Determines if a specific 
project has any outstanding locks. 





Property UserKey As Long _ read-only 
UserKey | Member of ReqPro40.Project Returns the key 
of the current user 


PWD Property PWD As String Member of 
ReqPro40.Application Sets a default password 


Property 
PermissionsForReqTraceability(IReqTypeKey As 
Long) As enumPermissions — read-only 

PermissionsForReqTraceability | Member of ReqPro40.Project Returns the 
current user's permissions for editing the 
traceability of requirements of the requirement 
type (data). 





Function Command([vOne], [vT wo], [vThree]) 
Command | Member of ReqPro40.Project Generic Interface 
for providing additional functionality. 


Sub Revert([bRevertAll As Boolean = False]) 
Revert | Member of ReqPro40.Views Restores objects 
to their state when originally created 


Function GetCurrentProjectUsers(sRQSPath As 
GetCurrentProjectUsers | String) As Properties Member of 
ReqPro40.Application 





Property DBProperties As Object read-only 
DBProperties | Member of ReqPro40.Project Returns the 
properties for the project 


Property Version As String read-only 
Version |Member of ReqPro40.Application Returns the 
version of the application 


Property IsServerOpen As Boolean _ read-only 
IsServerOpen | Member of ReqPro40.Application Determines 
whether the server is running 





Property IsOpenedReadOnly As Boolean _ read- 
only Member of ReqPro40.Project Returns 
whether the current user has opend the project 
read only 


CloseServer | Sub CloseServer() Member of 
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Slot nan e 


IsOpenedExclusive 


PersonalCatalog 


CompareVersionNumber 


VersionMajor 


DocSaveFormat 


GetRootPackage 


GetRequirement 


PermissionsForAttr 


PersonalCatalogltem 


Action 


Template Slots 


ReqPro40.Application Reserved 


Cardinality 


Property IsOpenedExclusive As Boolean _ read- 
only Member of ReqPro40.Project Returns 
whether the current user has opened the project 
exclusively 


Property PersonalCatalog As Catalog read-only 
Member of ReqPro40.Applicat ion Returns the 
local Catalog object 


Function CompareVersionNumber(sNumber! As 
String, sNumber2 As String) Member of 
ReqPro40.Application Compares version 
numbers 


Property VersionMajor As Long _ read-only 
Member of ReqPro40.Application Returns the 
major version number of the application 





Property DocSaveFormat As 
enumDocSaveFormat Member of 
ReqPro40.Project Returns the document save 
format 


Function GetRootPackage([bLoadAllPackages 
As Boolean = False]) As RootPackage Member 
of ReqPro40.Project 


Function GetRequirement(vReqLookupValue, 
[eReqLookupType As 
enumRequirementLookups = eReqLookup_Key], 
[eWeight As enumRequirementsWeights = 
eReqWeight_Medium], [eFlags As 
enumRequirementFlags]) As Requirement 
Member of ReqPro40.Project Returns the 
object for the specified requirement 





Property PermissionsForAttr(IReqTypeKey As 
Long, lAttrkKey As Long) As enumPermissions 
read-only Member of ReqPro40.Project 
Returns the current user's permissions for editing 
the AttrValues of the Attr type (data). 





Property 
PersonalCatalogItem(vCatLookup Value, 
[eCatLookupType As enumCatalogLookups = 
eCatLookup_Name]) As CatalogItem read-only 
Member of ReqPro40.Application Returns the 
specified catalog item from the Local catalog 
collection 


String 
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Event Action(eEventType As enumEventTypes, 
eObjectType As enumInterfaceldentifiers, 
sGUID As String, vEventData, eEventDataType ny 
As enumEventDataTypes, eEventSubType As 
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Template Slots 


enumEventSubTypes, sTimestamp As String) 
Member of ReqPro40.Application 


Cardinality 


Property VersionMinor As Long _ read-only 


VersionMinor | Member of ReqPro40.Application Returns the 
minor version number of the application 





Property AreProjectsLocked As Boolean _ read- 
only Member of ReqPro40.Application 


SetExclusiveA Property SetExclusiveAccess As Boolean 
SUBSEMUSIVEROCESS | 9 eoobyer Of ReqPro040.Project 


Property ProjectLockCount(vProjLookupValue, 
[eProjLookuptype As enumProjectLookups]) As 
ProjectLockCount|Long read-only Member of 
ReqPro40.Application Returns the number of 
ouststanding locks on a project object. 


AreProjectsLocked 





Property PermissionsForReqType(IReqTypeKey 
As Long) As enumPermissions — read-only 
PermissionsForReqType | Member of ReqPro40.Project Returns the 
current user's permissions for editing the 
requirements of the requirement type (data). 





Property AuthorID As Long _ read-only 


AuthorID Member of ReqPro40.Project 


Property SecurityEnabled As Boolean Member 
SecurityEnabled | of ReqPro40.Project Returns or sets whether 
security is enabled for the project 


Property AutoSuspect As Boolean Member of 
AutoSuspect | ReqPro40.Project Returns or sets whether 
requirements are auto suspect 
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Property Count As Long read-only Member 
Count| of ReqPro40.Views Returns the number of 
View objects in the collection 


> 


ny 





Property XMLVersion As Long _ read-only 
Member of ReqPro40.Project 


Sub RefreshSecurity() Member of 
RefreshSecurity | ReqPro40.Project Retrieves current security 
information from the database 


XMLVersion 


Function QueryFetch(eQueryBaseType As 
enumQueryBaseTypes, eQueryFormat As 
QueryFetch | enumQueryFormats, sQueryString As String, 


[oQueryDef As Object]) Member of 
ReqPro40.Project Executes the specified query 


Sub UnlockProject(sGUID As String, 
vProjLookupValue, [eProjLookuptype As 


enumProjectLookups]) Member of 
ReaPro40.Annlication Removes a lock from a 


UnlockProject 
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Slot nan e 


PermissionsForDocType 


Item 


GetRequirements 


GetPackage 


PermissionsForReqText 


OpenProjectProperties 


VersionDBSchema 


PublishAction 


GetDiscussionItem 





Template Slots 


specific project. 


Cardinality 


Property PermissionsForDocType(IDocTypeKey 
As Long) As enumPermissions — read-only 
Member of ReqPro40.Project Returns the 
current user's permissions for editing the 
Documents of the Document type (data). 


n 
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Property Item(v ViewLookupValue, 
[eViewLookupType As enumViewLookups = 
eViewLookup_Key]) As View _ read-only 
Default member of ReqPro40.Views Returns 
the specified View 


Function GetRequirements(vReqsLookup Value, 
[eReqsLookupType As 
enumRequirementsLookups = 
eReqsLookup_ReqTypeKey], [eWeight As 
enumRequirementsWeights = 
eReqWeight_Medium], [eFlags As 
enumRequirementFlags], [IPageSize As Long = 
1000], [IPages As Long = 2]) As Requirements 
Member of ReqPro40.Project Returns the 
requirements in the project 


n 
= 
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Function GetPackage(IKey As Long, [eWeight 
As enumPackageWeights = 
ePackageWeight_Empty]) As Package Member 
of ReqPro40.Project 


Property PermissionsForReqText(IReqTypeKey 
As Long) As enumPermissions — read-only 
Member of ReqPro40.Project 


unction 
OpenProjectProperties(vOpenProjOptionValue, 
[eOpenProjOptionType As 
enumOpenProjectOptions = 
eOpenProjOpt_RQSFile]) As Properties 
Member of ReqPro40.Application Opens a 
RequisitePro project and returns its properties 


Property VersionDBSchema As Long _ read-only 
Member of ReqPro40.Project Returns the 
database schema version number 


Sub PublishAction(eEventType As 
enumEventTypes, eObjectType As 
enumInterfaceldentifiers, sGUID As String, 


vEventData, eEventDataType As 
enumEventDataTypes, eEventSubType As 
enumEventSubTypes) Member of 
ReqPro40.Application 


Function GetDiscussionItem(IKey As Long) As | String 
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Template Slots 


Object Member of ReqPro40.Project Returns 
the specified discussion or response 


Cardinality 


Property IsModified As Boolean _ read-only 
Member of ReqPro40.Views Returns whether 


isModiied any of the Views in the collection have been 


modified 


Sub DropObjects(eInterfaceID As 
enumInterfacelIdentifiers) Member of 
ReqPro40.Project Removes collections from 
the Project object 





DropObjects 


Property CustomTypes As CustomTypes _ read- 
oCustomTypes | only Member of ReqPro40.Application 
Reserved for future use. 


Property EventRaiseEnabled As Boolean 
EventRaiseEnabled | Member of ReqPro40.Application Returns or 
sets whether the server raises server events 


Couns Function GetCurrentUsers() As Properties 
Member of ReqPro40.Project 


Property 
PermissionsForListItemType(IReqTypeKey As 
Long, 1AttrKey As Long, IListItemKey As Long) 

PermissionsForListItemType | As enumPermissions read-only Member of 
ReqPro40.Project Returns the current user's 
permissions for editing the ListItemValue of the 
ListItem type (data). 


Boolean 





Property IsProjectOpen As Boolean read-only 
IsProjectOpen | Member of ReqPro40.Project Returns whether 
the current user has the project open 


Boolean 


Function LockProject(vProjLookupValue, 
[eProjLookuptype As enumProjectLookups]) As 
String Member of ReqPro40.Application 
Locks a specific open project. 


LockProject 


Function CreateRequirement(sName As String, 
sText As String, VReqTypeLookupValue, 
[eReqTypeLookupType As 
enumReqTypesLookups = 
eReqTypesLookups_Key], [sVersionLabel As 
CreateRequirement | String], [sVersionReason As String], 
[vParentReqLookup Value], 
[eParent ReqLookupType As 
enumRequirementLookups = 
eReqLookup_Empty]) As Requirement 
Member of ReqPro40.Project 


Property IsValidLock(sGUID As String, 
IsValidLock | vProjLookupValue, [eProjLookuptype As 
enumProjectLookups]) As Boolean read-only 
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String 
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Template Slots 


Member of ReqPro40.Application Returns a 


Slot nan e 








whether the supplied GUID represents a valid 
lock. 


CLASS REQUIREMENTS 






Template Slots 


Function GetPackage(IKey As Long, [eWeight 
As enumPackageWeights = 


Cardinality 


Cehackaae ePackageWeight_Empty]) As Package Member 


of ReqPro40.Project 
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Property Count As Long read-only Member 
Count)| of ReqPro40.Views Returns the number of 
View objects in the collection 





Property Item(vViewLookupValue , 
[eViewLookupType As enumViewLookups = 

Item | eViewLookup_Key]) As View _ read-only 
Default member of ReqPro40.Views Returns 
the specified View 


B 
=< 





Property IsOpenedExclusive As Boolean _ read- 
only Member of ReqPro40.Project Returns 
whether the current user has opened the project 
exclusively 


IsOpenedExclusive 


Function 
GetRequirementsCount(vReqsLookupValue, 
[eReqsLookupType As 

GetRequirementsCount | enumRequirementsLookups = 
eReqsLookup_ReqTypeKey]) As Long 
Member of ReqPro40.Project Returns the count 
of records returned by a query. 





Property AreProjectsLocked As Boolean _ read- 


AreProjectsLocked 
shvich Acasa only Member of ReqPro40.Application 
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Function CreateRequirement(sName As String, 
sText As String, vVReqTypeLookupValue, 
[eReqTypeLookupType As 
enumReqTypesLookups = 
eReqTypesLookups_Key], [sVersionLabel As 

CreateRequirement | String], [sVersionReason As String], 
[vParentReqLookup Value], 
[eParentReqLookupType As 
enumRequirementLookups = 
eReqLookup_Empty]) As Requirement 
Member of ReqPro40.Project 
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Property VersionDBSchema As Long _ read-only 
VersionDBSchema | Member of ReqPro40.Project Returns the 
database schema version number 


String 
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Slot nan e 


GetCurrentProjectUsers 


PersonalCatalogltem 


Refresh 


GetRootPackage 


OpenProjectProperties 


GetDiscussionItem 


PermissionsForDocType 


DocSaveFormat 


PermissionsForReqText 


Version 


Action 


Template Slots 


Function GetCurrentProjectUsers(sRQSPath As 
String) As Properties Member of String 
ReqPro40.Application 


Property 

PersonalCatalogItem(vCatLookup Value, 
[eCatLookupType As enumCatalogLookups = 
eCatLookup_Name]) As CatalogItem read-only | String 
Member of ReqPro40.Application Returns the 
specified catalog item from the Local catalog 

collection 


Sub Refresh() Member of ReqPro40.View — |Any = |0:1. 


Function GetRootPackage([bLoadAl]lPackages 
As Boolean = False]) As RootPackage Member 
of ReqPro40.Project 








String 


unction 
OpenProjectProperties(vOpenProjOptionValue, 
[eOpenProjOptionType As 
enumOpenProjectOptions = 
eOpenProjOpt_RQSFile]) As Properties 
Member of ReqPro40.Application Opens a 
RequisitePro project and returns its properties 


Function GetDiscussionItem(1Key As Long) As 
Object Member of ReqPro40.Project Returns 
the specified discussion or response 


Property PermissionsForDocType(IDocTypeKey 
As Long) As enumPermissions — read-only 
Member of ReqPro40.Project Returns the 
current user's permissions for editing the 
Documents of the Document type (data). 


Property DocSaveFormat As 
enumDocSaveFormat Member of 
ReqPro40.Project Returns the document save 
format 





Property PermissionsForReqText(IReqTypeKey 
As Long) As enumPermissions — read-only 
Member of ReqPro40.Project 





Property Version As String read-only 
Member of ReqPro40.Application Returns the 
version of the application 





Event Action(eEventType As enumEventTypes, 
eObjectType As enumInterfaceldentifiers, 
sGUID As String, vEventData, eEventDataT ype 
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As enumEventDataTypes, eEventSubType As 
enumEventSubTypes, sTimestamp As String) 
Member of ReqPro40.Application 
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Slot nan e 


GetRequirements 


SecurityEnabled 


RefreshSecurity 


NewReqProCollection 


VersionRev 


LockProject 


DropObjects 


IsOpenedReadOnly 


ExtendedHelp 


oCustomTypes 


ChangeLoggedInUser 


Template Slots 


Function GetRequirements(vReqsLookup Value, 
[eReqsLookupType As 
enumRequirementsLookups = 
eReqsLookup_ReqTypeKey], [eWeight As 
enumRequirementsWeights = 
eReqWeight_Medium], [eFlags As 
enumRequirementFlags], [IPageSize As Long = 
1000], [IPages As Long = 2]) As Requirements 
Member of ReqPro40.Project Returns the 
requirements in the project 


Property SecurityEnabled As Boolean Member 
of ReqPro40.Project Returns or sets whether 
security is enabled for the project 


Sub RefreshSecurity() Member of 
ReqPro40.Project Retrieves current security 
information from the database 


Property NewReqProCollection As 
ReqProCollection read-only Member of 
ReqPro40.Project Returns a new 
ReqProCollection object. 


Property VersionRev As Long read-only 
Member of ReqPro40.Application Returns the 
version revision number 


Function LockProject(vProjLookupValue, 
[eProjLookuptype As enumProjectLookups]) As 
String Member of ReqPro40.Application 
Locks a specific open project. 


Sub DropObjects(eInterfaceID As 
enumInterfacelIdentifiers) Member of 
ReqPro40.Project Removes collections from 
the Project object 


Property IsOpenedReadOnly As Boolean _ read- 
only Member of ReqPro40.Project Returns 
whether the current user has opend the project 
read only 


Sub ExtendedHelp(sProduct As String, sSubTool 
As String, sItem As String, sOperation As String, 
sQuery As String) Member of 
ReqPro40.Application Launches Rational 
Extended Help 


Property CustomTypes As CustomTypes _ read- 
only Member of ReqPro40.Application 
Reserved for future use. 


Function ChangeLoggedInUser(v Value, 
[eUserLookup As enumUserLookups = 
eUserLookups_Key], [vValue2]) As Boolean 
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Boolean 


Boolean 
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Template Slots 


Member of ReqPro40.Project Changes the user 
logged into the project. 


Cardinality 






Function Command([vOne], [vT wo], [vThree]) 
Command | Member of ReqPro40.Project Generic Interface | String 
for providing additional functionality. 


Sub Save() Member of ReqPro40.Views Save 
all Views that have changed to the database 


Save 


> 
56 
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Function QueryFetch(eQueryBaseType As 
enumQueryBaseTypes, eQueryFormat As 
QueryFetch | enumQueryFormats, sQueryString As String, 
[oQueryDef As Object]) Member of 
ReqPro40.Project Executes the specified query 


Property IsProjectOpen As Boolean read-only 
IsProjectOpen | Member of ReqPro40.Project Returns whether 
the current user has the project open 


Property LockCount As Long _ read-only 
LockCount | Member of ReqPro40.Project Returns the 
number of outstanding locks against the Project. 


Function GetRequirement(vReqLookupValue, 
[eReqLookupType As 
enumRequirementLookups = eReqLookup_Key], 
[eWeight As enumRequirementsWeights = 
eReqWeight_Medium], [eFlags As 
enumRequirementFlags]) As Requirement 
Member of ReqPro40.Project Returns the 
object for the specified requirement 


GetC, U Function GetCurrentUsers() As Properties 
Or urrentSETS | Neember of ReqPro040.Project 


Property IsCurrentUserAdmin As Boolean 
read-only Member of ReqPro40.Project 
Returns whether the current user has 
administrative permissions 


GetRequirement 





IsCurrentUserAdmin 


Property IsLocked As Boolean — read-only 
IsLocked | Member of ReqPro40.Project Returns a value 
indicating whether or not the Project is locked. 





Property PersonalCatalog As Catalog read-only 
PersonalCatalog | Member of ReqPro40.Application Returns the 
local Catalog object 





Property PermissionsForReqType(IReqTypeKey 
As Long) As enumPermissions — read-only 
PermissionsForReqType | Member of ReqPro40.Project Returns the 
current user's permissions for editing the 
requirements of the requirement type (data). 


Property IsInDB(IKey As Long, eInterfaceID As 
fine enumInterfaceldentifiers, [sVersionNumber As Boolean 
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Template Slots 


String]) As Boolean read-only Member of 
ReqPro40.Project Returns whether the specified 
object is in the database 


Cardinality 


Property VersionMinor As Long _ read-only 
VersionMinor | Member of ReqPro40.Application Returns the 
minor version number of the application 


Property EventRaiseEnabled As Boolean 
EventRaiseEnabled | Member of ReqPro40.Application Returns or 
sets whether the server raises server events 


Boolean 


Property PermissionsForReqName(IReqTypeKey 
PermissionsForReqName | As Long) As enumPermissions — read-only 
Member of ReqPro40.Project 


Property 
PermissionsForListItemType(IReqTypeKey As 
Long, lAttrKey As Long, IListItemKey As Long) 

PermissionsForListltemType | As enumPermissions read-only Member of 
ReqPro40.Project Returns the current user's 
permissions for editing the ListItemValue of the 
ListItem type (data). 


Property 
PermissionsForReqTraceability(IReqTypeKey As 
Long) As enumPermissions — read-only 

PermissionsForReqTraceability | Member of ReqPro40.Project Returns the 
current user's permissions for editing the 
traceability of requirements of the requirement 
type (data). 


Property IsModified As Boolean read-only 
Member of ReqPro40.Views Returns whether 
any of the Views in the collection have been 
modified 


IsModified 


Property LogRelationshipRevisions As Boolean 
LogRelationshipRevisions | Member of ReqPro40.Project Returns or sets 
whether relationships are logged in Revisions 


Property IsValidLock(sGUID As String, 
vProjLookupValue, [eProjLookuptype As 
enumProjectLookups]) As Boolean read-only 
Member of ReqPro40.Application Returns 
whether the supplied GUID represents a valid 
lock. 


Boolean 


IsValidLock 


Property RQSFilepath As String read-only 
ROQSFilepath |Member of ReqPro40.Project Returns the 
pathname of the .rqs file 


Property VersionMajor As Long _ read-only 
VersionMajor | Member of ReqPro40.Application Returns the 
major version number of the application 


n n n les} n n n n 
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Template Slots 


Property DBProperties As Object read-only 
DBProperties | Member of ReqPro40.Project Returns the 
properties for the project 


Cardinality 






Property AuthorID As Long _ read-only 
Member of ReqPro40.Project 


AuthorID 


Property AutoSuspect As Boolean Member of 


AutoSuspect | ReqPro40.Project Returns or sets whether 
requirements are auto suspect 


. Function ValidPackage_(IKey As Long) As 
Vala Package: Boolean Member of ReqPro40.Project 


Function Query Validate(eQueryBaseT ype As 
enumQueryBaseTypes, eQueryFormat As 
enumQueryFormats, sQueryString As String, 
[oQueryDef As Object]) As Long Member of 
ReqPro40.Project Checks the specified query 
for correct syntax 





QueryValidate 


Property SequenceKey As Long _ read-only 
Member of ReqPro40.Project Returns the 

SequenceKey | sequence key for the project. The sequence key is 
an incrementing number assigned as a project is 
opened. 


Closes Sub CloseServer() Member of 
Gee ReqPro40.Application Reserved 
PWD Property PWD As String Member of 
ReqPro40.Application Sets a default password 


Sub Revert([bRevertAll As Boolean = False]) 
Revert | Member of ReqPro40.Views Restores objects 
to their state when originally created 


2 2 2 2 2 2 
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ny 


Function CompareVersionNumber(sNumber1! As 
String, sNumber2 As String) Member of 
ReqPro40.Application Compares version 
numbers 


CompareVersionNumber 


Sub UnlockProject(sGUID As String, 
vProjLookupValue, [eProjLookuptype As 

UnlockProject | enumProjectLookups]) Member of 
ReqPro40.Application Removes a lock from a 
specific project. 


Property UserKey As Long _ read-only 
UserKey | Member of ReqPro40.Project Returns the key 
of the current user 


Property PermissionsForAttr(IReqTypeKey As 
Long, lAttrKey As Long) As enumPermissions 

PermissionsForAttr | read-only Member of ReqPro40.Project 
Returns the current user's permissions for editing 
the AttrValues of the Attr type (data). 
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Template Slots 


Property IsProjectLocked(vProjLookupValue, 

[eProjLookuptype As enumProjectLookups]) As 
IsProjectLocked | Boolean read-only Member of Boolean 

ReqPro40.Application Determines if a specific 

project has any outstanding locks. 


Property ProjectLockCount(vProjLookup Value, 
[eProjLookuptype As enumProjectLookups]) As 
ProjectLockCount|Long read-only Member of 
ReqPro40.Application Returns the number of 
ouststanding locks on a project object. 





Property XMLVersion As Long _ read-only 


nial venion Member of ReqPro40.Project 


Sub PublishAction(eEventType As 
enumEventTypes, eObjectType As 
enumInterfaceldentifiers, sGUID As String, 
PublishAction | vEventData, eEventDataType As 
enumEventDataTypes, eEventSubType As 
enumEventSubTypes) Member of 
ReqPro40.Application 


Property IsServerOpen As Boolean read-only 
IsServerOpen | Member of ReqPro40.Application Determines 
whether the server is running 


Boolean 


Property UserGroupKey As Long read-only 
UserGroupKey | Member of ReqPro40.Project Returns the group 
of the current user 


String 





Property SetExclusiveAccess As Boolean 
Member of ReqPro40.Project 





SetExclusiveAccess Boolean 


CLASS REQUIREMENT 


n n n 
= = = 
a. a. a. 
5 5 5 
gq aq gq 





Template Slots 


Property LogRelationshipRevisions As Boolean 
LogRelationshipRevisions | Member of ReqPro40.Project Returns or sets Boolean | 0:1 
whether relationships are logged in Revisions 


Property IsValidLock(sGUID As String, 
vProjLookupValue, [eProjLookuptype As 
; enumProjectLookups]) As Boolean read-only : : 
VanaEack Member of ReqPro40.Application Returns String a 
whether the supplied GUID represents a valid 
lock. 


? Property AreProjectsLocked As Boolean _ read- : 
arneTaecihonted only Member of ReqPro40.Application opens pe 
Property VersionMajor As Long _ read-only 
VersionMajor | Member of ReqPro40.Application Returns the | String 0:1 

major version number of the application 
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Slot nan e 


Display 


TraceFrom 


AuthorID 


Child 


XMLVersion 


Bookmark 


AutoSuspect 


TracesFrom 


Version 


OpenProjectProperties 


LockCount 


Template Slots 


Function Display(eDisplayMode As 

enumDisplayModes, eDisplayT ype As 

enumDisplayTypes) As Object Member of Seine 0:1 
ReqPro40.Requirement This method will . 
display a requirement dialog of the mode and 

type received. 

Property TraceFrom(vRelLookup Value, 

[eRelLookupType As enumRelationshipLookups 

= eRelLookup_DerivedKey]) As Relationship Sing 0:1 
read-only Member of ReqPro40.Requirement i 
Returns the Relationship object for the specified 

traced from object 


Property AuthorID As Long _ read-only : . 
Member of ReqPro40.Project une a 


Property Child(vRelLookupValue, 

[eRelLookupType As enumRelationshipLookups 

= eRelLookup_DerivedKey]) As Relationship Sting 0-1 
read-only Member of ReqPro40.Requirement , 
Returns the Relationship object for the specified 

child of this requirement 


Property XMLVersion As Long _ read-only Stri . 
Member of ReqPro40.Project ming . 
Property Bookmark As String read-only 

Member of ReqPro40.Requirement Returns the 


bookmark associated with this requirement (if 
any) 














String 0:1 


Property AutoSuspect As Boolean Member of 
ReqPro40.Project Returns or sets whether 
requirements are auto suspect 


Boolean | 0:1 


Property TracesFrom As Relationships _ read- 
only Member of ReqPro40.Requirement 


Returns a Relationships object representing all of 
the objects from which this requirement traces 


So 


String 


Property Version As String read-only 
Member of ReqPro40.Application Returns the 
version of the application 


String 


unction 
OpenProjectProperties(vOpenProjOptionValue, 
[eOpenProjOptionType As 
enumOpenProjectOptions = 
eOpenProjOpt_RQSFile]) As Properties 
Member of ReqPro40.Application Opens a 
RequisitePro project and returns its properties 


So 


String 


Property LockCount As Long _ read-only 
Member of ReqPro40.Project Returns the 
number of outstanding locks against the Project. 
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i=) 


So 
-_ = _ _ 


String 





Slot nan e 


CloseServer 


DocKey 


Item 


GetRequirementsCount 


QueryFetch 


IsPermittedFor 


IsOpenedExclusive 


DocSaveFormat 


TracesTo 


PermissionsForReqType 


Template Slots 


Sub CloseServer() Member of A 0-1 
ReqPro40.Application Reserved ny . 


Property DocKey As Long _ read-only 

Member of ReqPro40.Requirement Returns the Setne 0-1 
key for the Document object associated with this . 
requirement (if any) 





Property Item(v ViewLookupValue, 
[eViewLookupType As enumViewLookups = 
eViewLookup_Key]) As View read-only Any 
Default member of ReqPro40.Views Returns 
the specified View 


ae 


Function 
GetRequirementsCount(vReqsLookupValue, 
[eReqsLookupType As 
enumRequirementsLookups = 
eReqsLookup_ReqTypeKey]) As Long 

Member of ReqPro40.Project Returns the count 
of records returned by a query. 


ae 


String 


Function QueryFetch(eQueryBaseType As 
enumQueryBaseTypes, eQueryFormat As 
enumQueryFormats, sQueryString As String, 
[oQueryDef As Object]) Member of 
ReqPro40.Project Executes the specified query 


ae 


String 


Property IsPermittedFor(ePermission As 
enumPermissions, ePermissionFor As 
enumPermissionTypes) As Boolean read-only 
Member of ReqPro40.Requirement Returns 
whether the specified permissions are permitted 
for the specified permission type for the currently 
logged in user. The ReqType, ReqTraceability 
and ReqText permission types are valid types for 
this interface 


Boolean 


Property IsOpenedE xclusive As Boolean _ read- 
only Member of ReqPro40.Project Returns 
whether the current user has opened the project 
exclusively 


ae 


Boolean 


Property DocSaveFormat As 
enumDocSaveFormat Member of 
ReqPro40.Project Returns the document save 
format 


ae 


String 





Property TracesTo As Relationships read-only 
Member of ReqPro40.Requirement Returns a 


ae 


4 4 4 S 4 4 
a 


String 


Relationship object for the specified traces to 
object 





Property PermissionsForReqType(IReqTypeKey 


0:1 
As Long) As enumPermissions — read-only 


String 
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Template Slots 





Slot nan e 


PermissionsForReqName 


PersonalCatalog 


Flags 


IsLocked 


VersionMinor 


IsNew 


UserKey 


PermissionsForReqTraceability 


IsInDB 


GetPackage 


CreateRequirement 


Member of ReqPro40.Project Returns the 
current user's permissions for editing the 
requirements of the requirement type (data). 


Cardinality 


Property PermissionsForReqName(1ReqTypeKey 
As Long) As enumPermissions — read-only 
Member of ReqPro40.Project 


So 
an 


String 


Property PersonalCatalog As Catalog read-only 
Member of ReqPro40.Application Returns the 
local Catalog object 


So 
an 


String 


Property Flags As enumRequirementFlags 
read-only Member of ReqPro40.Requirement 
Returns the EnumRequirementFlags object 
associated with this requirement 


So 


String 


Property IsLocked As Boolean read-only 
Member of ReqPro40.Project Returns a value 
indicating whether or not the Project is locked. 


So 
an 


_ — —_ = _ _ 


Boolean 


Property VersionMinor As Long _ read-only 
Member of ReqPro40.Application Returns the 
minor version number of the application 


So 


String 





Property IsNew As Boolean _ read-only 
Member of ReqPro40.Requirement Indicates if 
the requirement is not new. 


Boolean 


Property UserKey As Long _ read-only 
Member of ReqPro40.Project Returns the key 
of the current user 





So 


String 


Property 
PermissionsForReqTraceability(IReqTypeKey 
As Long) As enumPermissions — read-only 
Member of ReqPro40.Project Returns the 
current user's permissions for editing the 
traceability of requirements of the requirement 
type (data). 


Property IsInDB(IKey As Long, eInterfaceID As 
enumInterfaceldentifiers, [sVersionNumber As 
String]) As Boolean read-only Member of 
ReqPro40.Project Returns whether the 
specified object is in the database 


So 


String 


0 


ae 


Boolean 


Function GetPackage(IKey As Long, [eWeight 
As enumPackageWeights = 
ePackageWeight_Empty]) As Package Member 
of ReqPro40.Project 


0 


ae 


String 


Function CreateRequirement(sName As String, 
sText As String, VReqTypeLookupValue, 
[eReqTypeLookupType As 
enumReqTypesLookups = 


String 
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Slot nan e 


SecurityEnabled 


IsProjectOpen 


ChangeLoggedInUser 


Text 


Children 


RefreshSecurity 


oCustomTypes 


VersionRev 


QueryValidate 


IsOpenedReadOnly 


SuspectDateTime 


Template Slots 





Cardinality 


eReqTypesLookups_Key], [sVersionLabel As 
String], [sVersionReason As String], 
[vParentReqLookup Value], 
[eParentReqLookupType As 
enumRequirementLookups = 
eReqLookup_Empty]) As Requirement 
Member of ReqPro40.P roject 


Property SecurityEnabled As Boolean Member 
of ReqPro40.Project Returns or sets whether 
security is enabled for the project 


Boolean | 0:1 


Property IsProjectOpen As Boolean read-only 
Member of ReqPro40.Project Returns whether 
the current user has the project open 


Boolean | 0:1 


Function ChangeLoggedInUser(v Value, 
[eUserLookup As enumUserLookups = 
eUserLookups_Key], [vValue2]) As Boolean 


Member of ReqPro40.Project Changes the user 
logged into the project. 


Boolean | 0:1 


Property Text As String Member of 
ReqPro40.Requirement Returns or sets the 
textual definition for this requirement 


So 


String 





Property Children As Relationships read-only 
Member of ReqPro40.Requirement Returns a 
collection of Relationship objects representing 
the children of this requirement 


Sub RefreshSecurity() Member of 
ReqPro40.Project Retrieves current security 
information from the database 


String 


So 


String 


Property CustomTypes As CustomTypes _ read- 
only Member of ReqPro40.Application 
Reserved for future use. 


So 


String 


Property VersionRev As Long _ read-only 
Member of ReqPro40.Application Returns the 
version revision number 


So 


String 





Function Query Validate(eQueryBaseType As 
enumQueryBaseTypes, eQueryFormat As 
enumQueryFormats, sQueryString As String, 
[oQueryDef As Object]) As Long Member of 
ReqPro40.Project Checks the specified query 
for correct syntax 


So 
an 


i=) 
an an an an an 


String 


Property IsOpenedReadOnly As Boolean _ read- 
only Member of ReqPro40.Project Returns 
whether the current user has opend the project 
read only 


Propertv SuspectDateTime As String read-only | String 0:1 


Boolean | 0:1 
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Template Slots 





Slot nan e 


SequenceKey 


DeleteRequirementHierarchy 


PermissionsForListltemType 


VersionDBSchema 


Count 


SetExclusiveAccess 


ExtendedHelp 


Level 


IsCurrentUserAdmin 


IsRoot 


Member of ReqPro40.Requirement =a =a 


Property SequenceKey As Long _ read-only 

Member of ReqPro40.Project Returns the 

sequence key for the project. The sequence key is | String 
an incrementing number assigned as a project is 

opened. 


Sub DeleteRequirementHierarchy([eDeleteFlag 
As enumRequirementDeleteFlags = 
eReqDelFlag_Empty], 
[vNewParentLookupValue], 
[vNewParentLookupType As 
enumRequirementLookups = eReqLookup_Key]) 
Member of ReqPro40.Requirement Deletes a 
requirement from the project and provides 
options for dealing with hierarchical children. 


String 


Property 
PermissionsForListItemType(IReqTypeKey As 
Long, lAttrKey As Long, IListItemKey As Long) 
As enumPermissions read-only Member of 
ReqPro40.Project Returns the current user's 
permissions for editing the ListItemValue of the 
ListItem type (data). 


String 


Property VersionDBSchema As Long _ read- 
only Member of ReqPro40.Project Returns 
the database schema version number 


String 





Property Count As Long read-only Member 
of ReqPro40.Views Returns the number of Any 
View objects in the collection 


Property SetExclusiveAccess As Boolean Hasiean 
Member of ReqPro40.Project 

Sub ExtendedHelp(sProduct As String, sSubTool 
As String, sItem As String, sOperation As String, 
sQuery As String) Member of 


ReqPro40.Application Launches Rational 
Extended Help 





0:1 


String 


Property Level As Long read-only Member 
of ReqPro40.Requirement Returns the 
hierarchical level of this requirement 


String 


Property IsCurrentUserAdmin As Boolean 
read-only Member of ReqPro40.Project 
Returns whether the current user has 
administrative permissions 


Boolean 


Property IsRoot As Boolean read-only 
Member of ReqPro40.Requirement Returns 
whether this requirement is a root requirement 


Boolean 


2 S S 2 2 S 2 2 S 
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Slot nan e 


HasParent 


DBState 


GetRequirements 


Action 


IsProjectLocked 


CompareVersionNumber 


NewReqProCollection 


Refresh 


GetDiscussions 


GetRequirement 


Template Slots 





Cardinality 


Property HasParent([lCount As Long]) As 
Boolean read-only Member of 


Boolean | 0:1 


ReqPro40.Requirement Returns whether this 
requirement has a parent 





Property DBState As String read-only 
Member of ReqPro40.Requirement Returns the 
state of the object in the underlying datasource. 


So 


String 


Function GetRequirements(vReqsLookup Value, 
[eReqsLookupType As 
enumRequirementsLookups = 
eReqsLookup_ReqTypeKey], [eWeight As 
enumRequirementsWeights = 
eReqWeight_Medium], [eFlags As 
enumRequirementFlags], [IPageSize As Long = 
1000], [IPages As Long = 2]) As Requirements 
Member of ReqPro40.Project Returns the 
requirements in the project 


String 


ae 


Event Action(eEventType As enumEventTypes, 
eObjectType As enumInterfaceldentifiers, 
sGUID As String, vEventData, eEventDataType 
As enumEventDataTypes, eEventSubType As 
enumEventSubTypes, sTimestamp As String) 
Member of ReqPro40.Application 


Any 


Property IsProjectLocked(vProjLookupValue, 
[eProjLookuptype As enumProjectLookups]) As 
Boolean read-only Member of 
ReqPro40.Application Determines if a specific 
project has any outstanding locks. 


So 
an 


Boolean 





Function CompareVersionNumber(sNumber! As 
String, sNumber2 As String) Member of 
ReqPro40.Application Compares version 
numbers 


String 





Property NewReqProCollection As 
ReqProCollection read-only Member of 
ReqPro40.Project Returns a new 
ReqProCollection object. 


Sub Refresh() Member of ReqPro40.View Any 


Function GetDiscussions() As Discussions 
Member of ReqPro40.Requirement Returns the 
Discussions object associated with this 
requirement 


i=) 
an 


String 


ae 





S 
an 


String 


Function GetRequirement(vReqLookup Value, 
[eReqLookupType As 
enumRequirementLookups = eReqLookup_Key], 
[eWeight As enumRequirementsWeights = 
eReqWeight_Medium], [eFlags As 


String 


4 S S S S S 4 4 S 
a a a 





an 
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Slot nan e 


PersonalCatalogltem 


PermissionsFor 


TraceTo 


GetCurrentUsers 


GetDiscussionItem 


UnlockProject 


Command 


IsModified 


Save 


DBProperties 


Template Slots 





Cardinality 


enumRequirementFlags]) As Requirement 


Member of ReqPro40.Project Returns the 
object for the specified requirement 





Property 


PersonalCatalogItem(vCatLookup Value, 

[eCatLookupType As enumCatalogLookups = 
eCatLookup_Name]) As CatalogItem read-only | String 0:1 
Member of ReqPro40.Application Returns the 

specified catalog item from the Local catalog 






collection 


Property PermissionsFor(ePermissionFor As 
enumPermissionTypes) As enumPermissions 
read-only Member of ReqPro40.Requirement 
Returns the permissions for the currently logged 
in user for the permission type specified. The 
ReqType, ReqTraceability and ReqText 
permission types are valid types for this interface. 


String 0:1 





Property TraceTo(vRelLookupValue, 
[eRelLookupType As enumRelationshipLookups 
= eRelLookup_DerivedK ey]) As Relationship 
read-only Member of ReqPro40.Requirement 
Returns a Relationships object representing all of 
the objects to which this requirement traces 


Function GetCurrentUsers() As Properties Stri 0:1 
Member of ReqgPro40.Project ming . 


Function GetDiscussionItem(1Key As Long) As 
Object Member of ReqPro40.Project Returns 
the specified discussion or response 


Sub UnlockProject(sGUID As String, 
vProjLookupValue, [eProjLookuptype As 
enumProjectLookups]) Member of 
ReqPro40.Application Removes a lock from a 
specific project. 


String 0:1 





String 0:1 


String 0:1 


Function Command([vOne], [vT wo], [vThree]) 
Member of ReqPro40.Project Generic Interface 
for providing additional functionality. 


String 0 


Property IsModified As Boolean _ read-only 
Member of ReqPro40.Views Returns whether 
any of the Views in the collection have been 
modified 


Boolean | 0:1 





Sub Save() Member of ReqPro40.Views Save 
all Views that have changed to the database 


i=) 


y 


Property DBProperties As Object read-only 
0:1 


Member of ReqPro40.Project Returns the 
properties for the project 


String 


i=) 
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Slot nan e 


GetRootPackage 


PermissionsForAttr 


UserGroupKey 


EventRaiseEnabled 


LockProject 


AssignParent 


HasTracesFrom 


PermissionsForReqText 


NextVersionNumber 


HasTracesTo 


DropObjects 


Template Slots 





Cardinality 


Function GetRootPackage([bLoadAllPackages 
As Boolean = False]) As RootPackage Member 
of ReqPro40.Project 


String 0:1 


Property PermissionsForAttr(IReqTypeKey As 
Long, 1AttrKey As Long) As enumPermissions 
read-only Member of ReqPro40.Project 
Returns the current user's permissions for editing 
the AttrValues of the Attr type (data). 


So 
an 


String 


Property UserGroupKey As Long _ read-only 
Member of ReqPro40.Project Returns the 
group of the current user 


String 0:1 


Property EventRaiseEnabled As Boolean 
Member of ReqPro40.Application Returns or 
sets whether the server raises server events 


ae 


Boolean | 0 


Function LockProject(vProjLookupValue, 
[eProjLookuptype As enumProjectLookups]) As 
String Member of ReqPro40.Application 
Locks a specific open project. 


So 
an 


a a 


String 


Function AssignParent(vReqLookupValue, 
[eReqLookupType As 
enumRequirementLookups = eReqLookup_Key]) 
As Requirement Member of 
ReqPro40.Requirement Changes the 
requirement's parent or sets the it to the root 
level. 


String 





Property HasTracesFrom([ICount As Long]) As 
Boolean read-only Member of 
ReqPro40.Requirement Returns whether this 
requirement has any traces from other 
requirements. Optionally returns the number of 
these traces. 


0 


ae 


Boolean 


Property PermissionsForReqText(IReqTypeKey 
As Long) As enumPermissions — read-only 
Member of ReqPro40.Project 


So 
peg 


String 


Property NextVersionNumber As String read- 
only Member of ReqPro40.Requirement 
Returns the next sequential version number for 
this requirement 


So 
an 


String 





Property HasTracesTo([{ICount As Long]) As 
Boolean read-only Member of 
ReqPro40.Requirement Returns whether this 
requirement has any traces to other requirements. 


0 


ae 


Boolean 


Optionally returns the number of these traces. 


Sub DropObjects(eInterfaceID As 
enumInterfacelIdentifiers) Member of 
ReaPro40.Proiect Removes collections from 
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String 





Slot nan e 


GetCurrentProjectUsers 


DocPosition 


Tag 


ValidPackage_ 


PermissionsForDocType 


PWD 


IsServerOpen 


WeightName 


ProjectLockCount 


Revert 


IsDocBased 


ROQSFilepath 


PublishAction 


Template Slots 





Function GetCurrentProjectUsers(sRQSPath As 


S 
a 


String) As Properties Member of String 
ReqPro40.Application 





Property DocPosition As Long _ read-only 
Member of ReqPro40.Requirement Returns the 
position of the requirement within the document. 


So 
a 


String 


Property Tag({eTagFormat As enumTagFormat = 
eTagFormat_Tag]) As String read-only 
Member of ReqPro40.Requirement Returns the 
tag for this requirement 


Function ValidPackage_(IKey As Long) As Heal 
Boolean Member of ReqPro40.Project aes 


Property PermissionsForDocType(IDocTypeKey 
As Long) As enumPermissions — read-only 
Member of ReqPro40.Project Returns the 
current user's permissions for editing the 
Documents of the Document type (data). 


Property PWD As String Member of Strin 0-1 
ReqPro40.Application Sets a default password e . 


Property IsServerOpen As Boolean read-only 
Member of ReqPro40.Application Determines 
whether the server is running 


So 
an 


String 





0:1 


String 0:1 





So 
an 


Boolean 


Property WeightName As String read-only 
Member of ReqPro40.Requirement Returns a 
string representation of the weight of this object 


String 


Property ProjectLockCount(vProjLookupValue, 
[eProjLookuptype As enumProjectLookups]) As 
Long read-only Member of 
ReqPro40.Application Returns the number of 
ouststanding locks on a project object. 


Sub Revert([bRevertAll As Bo olean = False]) 
Member of ReqPro40.Views Restores objects 
to their state when originally created 


So 
— 


String 





So 
an 


a 


Boolean 


Property IsDocBased As Boolean read-only 
Member of ReqPro40.Requirement Returns 
whether this requirement lives in a document 


So 
= 


Boolean 





Property RQSFilepath As String read-only 
Member of ReqPro40.Project Returns the 
pathname of the .rqs file 





So 
= 


String 


Sub PublishAction(eEventType As 
enumEventTypes, eObjectType As 
enumInterfacelde ntifiers, sGUID As String, 
vEventData, eEventDataType As 


So 
an 


String 
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Template Slots 





Slot nan e Documentation 


Cardinality 








enumEventDataTypes, eEventSubType As 
enumEventSubTypes) Member of 
ReqPro40.Application 







CLASS ATTRVALUES 


Template Slots 


Function GetPackage(IKey As Long, [eWeight 
As enumPackageWeights = 
Cell aehaae ePackageWeight_Empty]) As Package BIE 


Member of ReqPro40.Project 





Property Count As Long read-only Member 
Count | of ReqPro40.Views Returns the number of 
View objects in the collection 


Property Item(v ViewLookupValue, 
[eViewLookupType As enumViewLookups = 
Item | eViewLookup_Key]) As View read-only Any 
ng 


Default member of ReqPro40.Views Returns 
the specified View 


Property IsOpenedExclusive As Boolean 
._|read-only Member of ReqPro40.Project 
IsGpenea reheat Returns whether the current user has opened the poo 


n 
n 
project exclusively 
Function 
GetRequirementsCount(vReqsLookupValue, 
[eReqsLookupType As 
GetRequirements Count | enumRequirementsLookups = Stri 
eReqsLookup_ReqTypeKey]) As Long 
Member of ReqPro40.Project Returns the 


count of records returned by a query. 


: Property AreProjectsLocked As Boolean 
AreP: Locked Bool 
calle soamccaes read-only Member of ReqPro40.Application cies 


Function CreateRequirement(sName As String, 
sText As String, VReqTypeLookupValue, 
[eReqTypeLookupType As 
enumReqTypesLookups = 
eReqTypesLookups_Key], [sVersionLabel As 

CreateRequirement | String], [sVersionReason As String], 
[vParentReqLookupValue], 
[eParentReqLookupType As 
enumRequirementLookups = 
eReqLookup_Empty]) As Requirement 
Member of ReqPro40.Project 


Property VersionDBSchema As Long _ read- 
VersionDBSchema | only Member of ReqPro40.Project Returns {String 


the database schema version number 
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Slot nan e 


Flags 


AssignParent 


GetCurrentProjectUsers 


PersonalCatalogltem 


Child 


Refresh 


GetRootPackage 


OpenProjectProperties 


GetDiscussionItem 


PermissionsForDocType 


Template Slots 


Property Flags As enumRequirementFlags 
read-only Member of ReqPro40.Requirement 
Returns the EnumRequirementFlags object 
associated with this requirement 





‘Cardinality 


String 


Function AssignParent(vReqLookupValue, 


[eReqLookupType As 
enumRequirementLookups = 
eReqLookup_Key]) As Requirement Member 
of ReqPro40.Requirement Changes the 
requirement's parent or sets the it to the root 
level. 


String 





Function GetCurrentProjectUsers(sRQSPath As 
String) As Properties Member of 
ReqPro40.Application 


n 
= 
a. 
5 
aq 





Property 

PersonalCatalogItem(vCatLookupValue, 
[eCatLookupType As enumCatalogLookups = 
eCatLookup_Name]) As CatalogItem read- {String 
only Member of ReqPro40.Application 

Returns the specified catalog item from the 

Local catalog collection 


Property Child(vRelLookupValue, 
[eRelLookupType As 
enumRelationshipLookups = 
eRelLookup_DerivedKey]) As Relationship 
read-only Member of ReqPro40.Requirement 
Returns the Relationship object for the 
specified child of this requirement 


Sub Refresh() Member of ReqPro40.View ny 


Function GetRootPackage([bLoadAl]Packages 
As Boolean = False]) As RootPackage 
Member of ReqPro40.Project 


String 





unction 
OpenProjectProperties(vOpenProjOption Value, 
[eOpenProjOptionType As 
enumOpenProjectOptions = 
eOpenProjOpt_RQSFile]) As Properties 
Member of ReqPro40.Application Opens a 
RequisitePro project and ret urns its properties 





Function GetDiscussionItem(1Key As Long) As 
Object Member of ReqPro40.Project 
Returns the specified discussion or response 


String 


Property 
PermissionsForDocType(IDocTypeKey As 
Long) As enumPermissions — read-only 
Member of ReqPro40.Project Returns the 


String 
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Slot nan e 


DocSaveFormat 


PermissionsForReqText 


Version 


IsNew 


Action 


Level 


DocPosition 


Tag 


GetRequirements 


SecurityEnabled 


Template Slots 


current user's permissions for editing the 
Documents of the Document type (data). 





‘Cardinality 


Property DocSaveFormat As 
enumDocSaveFormat Member of 


ReqPro40.Project Returns the document save 
format 





Property 
PermissionsForReqText(IReqTypeKey As 
Long) As enumPermissions — read-only 
Member of ReqPro40.Project 


Property Version As String read-only 
Member of ReqPro40.Application Returns 
the version of the application 


Property IsNew As Boolean _ read-only 
Member of ReqPro40.Requirement Indicates 
if the requirement is not new. 
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Event Action(eEventType As 
enumEventTypes, eObjectType As 
enumInterfaceIdentifiers, sGUID As String, 
vEventData, eEventDataType As 
enumEventDataTypes, eEventSubType As 
enumEventSubTypes, sTimestamp As String) 
Member of ReqPro40.Application 


> 


ny 


Property Level As Long read-only Member 
of ReqPro40.Requirement Returns the 
hierarchical level of this requirement 





Property DocPosition As Long _ read-only 
Member of ReqPro40.Requirement Returns 
the position of the requirement within the 
document. 


Property Tag([eTagFormat As enumTagFormat 
= eTagFormat_Tag]) As String read-only 
Member of ReqPro40.Requirement Returns 
the tag for this requirement 


Function 
GetRequirements(vReqsLookup Value, 
[eReqsLookupType As 
enumRequirementsLookups = 
eReqsLookup_ReqTypeKey], [eWeight As 
enumRequirementsWeights = 
eReqWeight_Medium], [eFlags As 
enumRequirementFlags], [IPageSize As Long = 
1000], [IPages As Long = 2]) As Requirements 
Member of ReqPro40.Project Returns the 
requirements in the project 


Property SecurityEnabled As Boolean Boolean 
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Slot nan e 


RefreshSecurity 


NewReqProCollection 


VersionRev 


LockProject 


DropObjects 


IsOpenedReadOnly 


ExtendedHelp 


oCustomTypes 


SuspectDateTime 


ChangeLoggedInUser 


Command 


Save 


Template Slots 


Member of ReqPro40.Project Returns or sets 
whether security is enabled for the project 


Sub RefreshSecurity() Member of 
ReqPro40.Project Retrieves current security 
information from the database 





‘Cardinality 


Property NewReqProCollection As 
ReqProCollection read-only Member of 
ReqPro40.Project Returns a new 
ReqProCollection object. 


Property VersionRev As Long read-only 
Member of ReqPro40.Application Returns 
the version revision number 


Function LockProject(vProjLookup Value, 
[eProjLookuptype As enumProjectLookups]) 
As String Member of ReqPro40.Application 
Locks a specific open project. 


Sub DropObjects(eInterfaceID As 
enumInterfaceldentifiers) Member of 
ReqPro40.Project Removes collections from 
the Project object 





Property IsOpenedReadOnly As Boolean 
read-only Member of ReqPro40.Project 
Returns whether the current user has opend the 
project read only 


Sub ExtendedHelp(sProduct As String, 
sSubTool As String, sItem As String, 
sOperation As String, sQuery As String) 
Member of ReqPro40.Application Launches 
Rational Extended Help 


Property CustomTypes As CustomTypes 
read-only Member of ReqPro40.Application 
Reserved for future use. 


String 





Property SuspectDateTime As String _ read- 
only Member of ReqPro40.Requirement 


Function ChangeLoggedInUser(v Value, 
[eUserLookup As enumUserLookups = 
eUserLookups_Key], [vValue2]) As Boolean 
Member of ReqPro40.Project Changes the 
user logged into the project. 


Boolean 


Function Command([vOne], [vT wo], [vThree]) 
Member of ReqPro40.Project Generic 
Interface for providing additional functionality. 


Sub Save() Member of ReqPro40.Views 
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Save all Views that have changed to the 
database 
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Template Slots 





Slot nan e 


QueryFetch 


DeleteRequirementHierarchy 


IsProjectOpen 


IsDocBased 


HasTracesTo 


LockCount 


Text 


GetRequirement 


GetCurrentUsers 


Function QueryFetch(eQueryBaseType As 
enumQueryBaseTypes, eQueryFormat As 
enumQueryFormats, sQueryString As String, 
[oQueryDef As Object]) Member of 
ReqPro40.Project Executes the specified 
query 


Sub DeleteRequirementHierarchy([eDeleteFlag 
As enumRequirementDeleteFlags = 
eReqDelFlag_Empty], 
[vNewParentLookupValue], 
[vNewParentLookupType As 

enum RequirementLookups = 
eReqLookup_Key]) Member of 
ReqPro40.Requirement Deletes a requirement 
from the project and provides options for 
dealing with hierarchical children. 


‘Cardinality 


String 


Property IsProjectOpen As Boolean _ read-only 
Member of ReqPro40.Project Returns 
whether the current user has the project open 


Property IsDocBased As Boolean read-only 
Member of ReqPro40.Requirement Returns 
whether this requirement lives in a document 


Property HasTracesTo([lCount As Long]) As 
Boolean read-only Member of 
ReqPro40.Requirement Returns whether this 
requirement has any traces to other 
requirements. Optionally returns the number of 
these traces. 


Property LockCount As Long read-only 
Member of ReqPro40.Project Returns the 
number of outstanding locks against the 
Project. 


Property Text As String Member of 
ReqPro40.Requirement Returns or sets the 
textual definition for this requirement 


String 


Function GetRequirement(vReqLookupValue, 
[eReqLookupType As 
enumRequirementLookups = 
eReqLookup_Key], [eWeight As 
enumRequirementsWeights = 
eReqWeight_Medium], [eFlags As 
enumRequirementFlags]) As Requirement 
Member of ReqPro40.Project Returns the 
object for the specified requirement 


Function GetCurrentUsers() As Properties Str 
Member of ReqPro40.Project mine 
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Slot nan e 


IsCurrentUserAdmin 


IsLocked 


HasTracesFrom 


PersonalCatalog 


NextVersionNumber 


TracesFrom 


IsRoot 


PermissionsForReqType 


IsInDB 


WeightName 


DocKey 





Template Slots 


Property IsCurrentUserAdmin As Boolean 
read-only Member of ReqPro40.Project 
Returns whether the current user has 
administrative permissions 


‘Cardinality 


Boolean 


Property IsLocked As Boolean read-only 
Member of ReqPro40.Project Returns a value 
indicating whether or not the Project is locked. 


Boolean 


Property HasTracesFrom([ICount As Long]) As 
Boolean read-only Member of 
ReqPro40.Requirement Returns whether this 
requirement has any traces from other 
requirements. Optionally returns the number of 
these traces. 


Property PersonalCatalog As Catalog  read- 


only Member of ReqPro40.Application 
Returns the local Catalog object 


Property NextVersionNumber As String read- 
only Member of ReqPro40.Requirement 
Returns the next sequential version number for 
this requirement 


Property TracesFrom As Relationships _ read- 
only Member of ReqPro40.Requirement 
Returns a Relationships object representing all 
of the objects from which this requirement 
traces 


String 


Property IsRoot As Boolean read-only 
Member of ReqPro40.Requirement Returns 
whether this requirement is a root requirement 


Boolean 





Property 
PermissionsForReqType(IReqTypeKey As 
Long) As enumPermissions — read-only 
Member of ReqPro40.Project Returns the 
current user's permissions for editing the 
requirements of the requirement type (data). 


Property IsInDB(IKey As Long, eInterfaceID 
As enumInterfaceldentifiers, [sVersionNumber 
As String]) As Boolean read-only Member 
of ReqPro40.Project Returns whether the 
specified object is in the database 


Boolean 


Property WeightName As String read-only 
Member of ReqPro40.Requirement Returns a 
string representation of the weight of this object 


String 





Property DocKey As Long _ read-only 


Member of ReqPro40.Requirement Returns : 
String 


the key for the Document object associated 
with this requirement (if any) 
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Slot nan e 


IsPermittedFor 


VersionMinor 


EventRaiseEnabled 


PermissionsForReqName 


Permissions ForListItemType 


PermissionsForReqTraceability 


IsModified 


LogRelationshipRevisions 


IsValidLock 


Template Slots 


‘Cardinality 


Property IsPermittedFor(ePermission As 
enumPermissions, ePermissionFor As 
enumPermissionTypes) As Boolean read-only 
Member of ReqPro40.Requirement Returns 
whether the specified permissions are permitted 
for the specified permission type for the 


Boolean 


currently logged in user. The ReqType, 
ReqTraceability and ReqText permission types 
are valid types for this interface 


Property VersionMinor As Long _ read-only 
Member of ReqPro40.Application Returns 
the minor version number of the application 


String 





Property EventRaiseEnabled As Boolean 
Member of ReqPro40.Application Returns or 
sets whether the server raises server events 


Boolean 


Property 
PermissionsForReqName(IReqTypeKey As 
Long) As enumPermissions — read-only 
Member of ReqPro40.Project 


Property 
PermissionsForListItemType(IReqTypeKey As 
Long, lAttrKey As Long, IListItemKey As 
Long) As enumPermissions — read-only 
Member of ReqPro40.Project Returns the 
current user's permissions for editing the 
ListItemValue of the ListItem type (data). 


Property 
PermissionsForReqTraceability(IReqTypeKey 
As Long) As enumPermissions — read-only 


Member of ReqPro40.Project Returns the 
current user's permissions for editing the 
traceability of requirements of the requirement 
type (data). 


Property IsModified As Boolean read-only 
Member of ReqPro40.Views Returns whether 
any of the Views in the collection have been 
modified 


Property LogRelationshipRevisions As Boolean 
Member of ReqPro40.Project Returns or sets 
whether relationships are logged in Revisions 


Property IsValidLock(sGUID As String, 
vProjLookupValue, [eProjLookuptype As 
enumProjectLookups]) As Boolean read-only 
Member of ReqPro40.Application Returns 
whether the supplied GUID represents a valid 
lock. 


Boolean 


String 
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Slot nan e 


ROQSFilepath 


VersionMajor 


PermissionsFor 


DBState 


DBProperties 


AuthorID 


AutoSuspect 


TraceTo 


ValidPackage_ 


QueryValidate 


SequenceKey 


Template Slots 
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Property RQSFilepath As String read-only 
Member of ReqPro40.Project Returns the 
pathname of the .rqs file 


Property VersionMajor As Long _ read-only 
Member of ReqPro40.Application Returns 
the major version number of the application 


Property PermissionsFor(ePermissionFor As 
enumPermissionTypes) As enumPermissions 
read-only Member of ReqPro40.Requirement 
Returns the permissions for the currently 
logged in user for the permission type 
specified. The ReqType, ReqTraceability and 
ReqText permission types are valid types for 
this interface. 





Property DBState As String read-only 
Member of ReqPro40.Requirement Returns 
the state of the object in the underlying 
datasource. 


Property DBProperties As Object read-only 
Member of ReqPro40.Project Returns the 
properties for the project 





Property AuthorID As Long read-only 
Member of ReqPro40.Project 


Property AutoSuspect As Boolean Member of 
ReqPro40.Project Returns or sets whether 
requirements are auto suspect 





Property TraceTo(vRelLookupValue, 
[eRelLookupType As 
enumRelationshipLookups = 
eRelLookup_DerivedKey]) As Relationship 
read-only Member of ReqPro40.Requirement 
Returns a Relationships object representing all 
of the objects to which this requirement traces 


Function ValidPackage_(IKey As Long) As 
Boolean Member of ReqPro40.Project 


Function Query Validate(eQueryBaseType As 
enumQueryBaseTypes, eQueryFormat As 
enumQueryFormats, sQueryString As String, 
[oQueryDef As Object]) As Long Member of 
ReqPro40.Project Checks the specified query 
for correct syntax 





Property SequenceKey As Long _ read-only 
Member of ReqPro40.Project Returns the 
sequence key for the project. The sequence key 
is an incrementing number assigned as a project 
is opened. 


String 
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Slot nan e 


CloseServer 


PWD 


TraceFrom 


HasParent 


Revert 


Compare VersionNumber 


UnlockProject 


UserKey 


PermissionsForAttr 


IsProjectLocked 


ProjectLockCount 


Template Slots 


Sub CloseServer() Member of 
ReqPro40.Application Reserved 
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Property PWD As String Member of 
ReqPro40.Application Sets a default 
password 


Property TraceFrom(vRelLookupValue, 
[eRelLookupType As 
enumRelationshipLookups = 
eRelLookup_DerivedKey]) As Relationship 
read-only Member of ReqPro40.Requirement 
Returns the Relationship object for the 
specified traced from object 


Property HasParent({[ICount As Long]) As 
Boolean read-only Member of 
ReqPro40.Requirement Returns whether this 
requirement has a parent 


Sub Revert([bRevertAll As Boolean = False]) 
Member of ReqPro40.Views Restores objects 
tot heir state when originally created 





Function Compare VersionNumber(sNumber1 
As String, sNumber2 As String) Member of 
ReqPro40.Application Compares version 
numbers 


Sub UnlockProject(sGUID Ass String, 
vProjLookupValue, [eProjLookuptype As 
enumProjectLookups]) Member of 
ReqPro40.Application Removes a lock from a 
specific project. 


Property UserKey As Long _ read-only 
Member of ReqPro40.Project Returns the key 
of the current user 


String 


Property PermissionsForAttr(IReqTypeKey As 
Long, 1AttrKey As Long) As enumPermissions 
read-only Member of ReqPro40.Project 
Returns the current user's permissions for 
editing the AttrValues of the Attr type (data). 


Property IsProjectLocked(vProjLookupValue, 
[eProjLookuptype As enumProjectLookups]) 
As Boolean read-only Member of 
ReqPro40.Application Determines if a 
specific project has any outstanding locks. 


Property 
ProjectLockCount(vProjLookup Value, 
[eProjLookuptype As enumProjectLookups]) 
As Long read-only Member of 
ReaPro40.Application Returns the number of 


String 
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Template Slots 


ouststanding locks on a project object. 


Property XMLVersion As Long _ read-only 
Member of ReqPro40.Project 





‘Sardinality 


XMLVersion 


Property TracesTo As Relationships read- 
only Member of ReqPro40.Requirement 
Returns a Relationship object for the specified 
traces to object 


TracesTo 


Sub PublishAction(eEventType As 
enumEventTypes, eObjectType As 
enumInterfaceIdentifiers, sGUID As String, 
PublishAction | vEventData, eEventDataType As 
enumEventDataTypes, eEventSubType As 
enumEventSubTypes) Member of 
ReqPro40.Application 


So 
an 


Property Children As Relationships read-only 
Member of ReqPro40.Requirement Returns a 
collection of Relationship objects representing 
the children of this requirement 


Children 


Function Display(eDisplayMode As 
enumDisplayModes, eDisplayType As 
enumDisplayTypes) As Object Member of 
ReqPro40.Requirement This method will 
display a requirement dialog of the mode and 
type received. 


Display 


Property Bookmark As String read-only 
Member of ReqPro40.Requirement Returns 
the bookmark associated with this requirement 
(if any) 


Bookmark 


Function GetDiscussions() As Discussions 
Member of ReqPro40.Requirement Returns 
the Discussions object associated with this 
requirement 


GetDiscussions 





Property IsServerOpen As Boolean _ read-only 
IsServerOpen | Member of ReqPro40.Application 
Determines whether the server is running 


Boolean 


Property UserGroupKey As Long _ read-only 
UserGroupKey | Member of ReqPro40.Project Returns the 
group of the current user 


String 





Property SetExclusiveAccess As Boolean 


Member of ReqPro40.Project Boolean 


SetExclusiveAccess 


CLASS ATTRVALUE 
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Template Slots 


LogRelationshipRevisions | Property LogRelationshipRevisions As Boolean 
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Template Slots 





Slot nan e 


PermissionsForAttr 


AreProjectsLocked 


GetRequirement 





TracesFrom 


DocKey 


PermissionsForReqTraceability 


DBProperties 


UserKey 


Revert 


‘Cardinality 


Member of ReqPro40.Project Returns or sets 





whether relationships are logged in Revisions 


Property PermissionsForAttr(IReqTypeKey As 

Long, lAttrkKey As Long) As enumPermissions 
read-only Member of ReqPro40.Project String 
Returns the current user's permissions for 

editing the AttrValues of the Attr type (data). 





Property AreProjectsLocked As Boolean 
read-only Member of ReqPro40.Application 


Function GetRequirement(vReqLookupValue, 
[eReqLookupType As 
enumRequirementLookups = 
eReqLookup_Key], [eWeight As 
enumRequirementsWeights = 
eReqWeight_Medium], [eFlags As 
enumRequirementFlags]) As Requirement 
Member of ReqPro40.Project Returns the 
object for the specified requirement 
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Property Key As Long read-only Member 
of ReqPro40.View Returns the unique key 
associated with this view 


> 


ny 


Property TracesFrom As Relationships _ read- 
only Member of ReqPro40.Requirement 
Returns a Relationships object representing all 
of the objects from which this requirement 
traces 


Property DocKey As Long _ read-only 
Member of ReqPro40.Requirement Returns 
the key for the Document object associated 
with this requirement (if any) 


Property 
PermissionsForReqTraceability(IReqTypeKey 
As Long) As enumPermissions — read-only 
Member of ReqPro40.Project Returns the 
current user's permissions for editing the 
traceability of requirements of the requirement 
type (data). 


Property DBProperties As Object read-only 
Member of ReqPro40.Project Returns the 
properties for the project 


String 


Property UserKey As Long _ read-only 
Member of ReqPro40.Project Returns the key 
of the current user 


String 


Sub Revert([bRevertAll As Boolean = False]) 
Member of ReqPro40.Views Restores objects 
to their state when originally created 
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Slot nan e 


DocSaveFormat 


IsCurrentUserAdmin 


VersionMajor 


AssignParent 


IsPermitted 


IsProjectOpen 


IsEdit 


AutoSuspect 


IsProjectLocked 


NewReqProCollection 


ReqTypeKey 











Template Slots 
‘Cardinality 


Property DocSaveFormat As 
enumDocSaveFormat Member of 
ReqPro40.Project Returns the document save 
format 


String 


Property IsCurrentUserAdmin As Boolean 
read-only Member of ReqPro40.Project 
Returns whether the current user has 
administrative permissions 


Property VersionMajor As Long _ read-only 


Member of ReqPro40.Application Returns 
the major version number of the application 


String 


Function AssignParent(vReqLookupValue, 
[eReqLookupType As 
enumRequirementLookups = 
eReqLookup_Key]) As Requirement Member 
of ReqPro40.Requirement Changes the 
requirement's parent or sets the it to the root 
level. 


Property IsPermitted(ePermissions As 
enumPermissions) As Boolean read-only 
Member of ReqPro40.View Returns whether 
the current user has the specified permissions 


Property IsProjectOpen As Boolean _ read-only 
Member of ReqPro40.Project Returns 
whether the current user has the project open 


Property IsEdit As Boolean _ read-only 
Member of ReqPro40.Attr Returns whether 
the attribute is editable ( not list or multiselect ) 





Boolean 


Property AutoSuspect As Boolean Member of 
ReqPro40.Project Returns or sets whether 
requirements are auto suspect 


Boolean 


Property IsProjectLocked(vProjLookupValue, 
[eProjLookuptype As enumProjectLookups]) 
As Boolean read-only Member of 
ReqPro40.Application Determines if a 
specific project has any outstanding locks. 


Property NewReqProCollection As 
ReqProCollection read-only Member of 
ReqPro40.Project Returns a new 
ReqProCollection object. 


Property ReqTypeKey As Long _ read-only 
Member of ReqPro40.Requirement Returns 
the key for the ReqType object associated with 
this requirement 
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Slot nan e 


HasTracesFrom 


IsDocBased 


DocPosition 


Bookmark 


GetCustomValue 


Text 


QueryFetch 


Tag 


Action 


Template Slots 
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PermissionsForListItemType(IReqTypeKey As 
Long, lAttrKey As Long, IListItemKey As 
Long) As enumPermissions — read-only 
Member of ReqPro40.Project Returns the 
current user's permissions for editing the 
ListItemValue of the ListItem type (data). 


Property HasTracesFrom([lCount As Long]) As 
Boolean read-only Member of 
ReqPro40.Requirement Returns whether this 
requirement has any traces from other 
requirements. Optionally returns the number of 
these traces. 


Property IsDocBased As Boolean — read-only 
Member of ReqPro40.Requirement Returns 
whether this requirement lives in a document 


Property DocPosition As Long _ read-only 
Member of ReqPro40.Requirement Returns 
the position of the requirement within the 
document. 


Property Bookmark As String read-only 
Member of ReqPro40.Requirement Returns 
the bookmark associated with this requirement 
(if any) 


Function GetCustomValue([hWnd As Long], 
[ITop As Long], [ILeft As Long], 
[sCurrentDisplay Value As String]) As Long 
Member of ReqPro40.AttrValue Reserved for 
future use. 


String 


Property Text As String Member of 
ReqPro40.Requirement Returns or sets the 
textual definition for this requirement 





Function QueryFetch(eQueryBaseType As 
enumQueryBaseTypes, eQueryFormat As 
enumQueryFormats, sQueryString As String, 
[oQueryDef As Object]) Member of 
ReqPro40.Project Executes the specified 


query 


Property Tag([eTagFormat As enumTagFormat 
= eTagFormat_Tag]) As String read-only 
Member of ReqPro40.Requirement Returns 
the tag for this requirement 


String 
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Event Action(eEventType As 
enumEventTypes, eObjectType As 


enumInterfaceldentifiers, sGUID As String, 
vEventData, eEventDataType As 
enumEventDataTypes, eEventSubType As 
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Slot nan e 


WeightName 


Count 


Item 


ChangeLoggedInUser 


TraceTo 


IsValidLock 


CreateRequirement 


DropObjects 


Template Slots 


enumEventSubTypes, sTimestamp As String) 
Member of ReqPro40.Application 





‘Cardinality 







Property WeightName As String read-only 
Member of ReqPro40.Requirement Returns a | String 
string representation of the weight of this object 


Property Count As Long read-only Member 
of ReqPro40.Views Returns the number of 
View objects in the collection 


> 
5 
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Property Item(vViewLookup Value, 
[eViewLookupType As enumViewLookups = 
eViewLookup_Key]) As View _ read-only 
Default member of ReqPro40.Views Returns 
the specified View 


Function ChangeLoggedInUser(vValue, 
[eUserLookup As enumUserLookups = 
eUserLookups_Key], [vValue2]) As Boolean 
Member of ReqPro40.Project Changes the 
user logged into the project. 


Boolean 


Property TraceTo(vRelLookupValue, 
[eRelLookupType As 
enumRelationshipLookups = 
eRelLookup_DerivedKey]) As Relationship 
read-only Member of ReqPro40.Requirement 
Returns a Relationships object representing all 
of the objects to which this requirement traces 


Property IsValidLock(sGUID As String, 
vProjLookupValue, [eProjLookuptype As 
enumProjectLookups]) As Boolean read-only 
Member of ReqPro40.Application Returns 
whether the supplied GUID represents a valid 
lock. 


String 


Function CreateRequirement(sName As String, 
sText As String, vVReqTypeLookupValue , 
[eReqTypeLookupType As 
enumReqTypesLookups = 
eReqTypesLookups_Key], [sVersionLabel As 
String], [sVersionReason As String], 
[vParentReqLookupValue], 
[eParentReqLookupType As 
enumRequirementLookups = 
eReqLookup_Empty]) As Requirement 
Member of ReqPro40.Project 


String 





Sub DropObjects(eInterfaceID As 


enumInterfacelIdentifiers) Member of ‘ 
String 


ReqPro40.Project Removes collections from 
the Project object 


wn > 
=e 5 
5 < 
ga 





175 


Template Slots 





Slot nan e 


DeleteRequirementHierarchy 


RefreshSecurity 


DataTypeName 


IsLocked 


PWD 


PermissionsForReqText 


IsInDB 


ProjectLockCount 


NextVersionNumber 


Refresh 


GetPackage 


Sub DeleteRequirementHierarchy([eDeleteFlag 
As enumRequirementDeleteFlags = 
eReqDelFlag_Empty], 
[vNewParentLookupValue], 
[vNewParentLookupType As 
enumRequirementLookups = 
eReqLookup_Key]) Member of 
ReqPro40.Requirement Deletes a requirement 
from the project and provides options for 
dealing with hierarchical children. 


Sub RefreshSecurity() Member of 
ReqPro40.Project Retrieves current security 
information from the database 


‘Cardinality 


String 


Property DataTypeName As String read-only 
Member of ReqPro40.ListItemValue Returns 
the text for the data type of the attribute 
associated with the list item value 


Property IsLocked As Boolean _ read-only 
Member of ReqPro40.Project Returns a value 


indicating whether or not the Pro ject is locked. 


Property PWD As String Member of 
ReqPro40.Application Sets a default 
password 


Property 
PermissionsForReqText(IReqTypeKey As 
Long) As enumPermissions — read-only 
Member of ReqPro40.Project 


Property IsInDB(IKey As Long, eInterfaceID 
As enumInterfaceldentifiers, [sVersionNumber 
As String]) As Boolean read-only Member 
of ReqPro40.Project Returns whether the 
specified object is in the database 


Property 
ProjectLockCount(vProjLookupValue, 
[eProjLookuptype As enumProjectLookups]) 
As Long read-only Member of 
ReqPro40.Application Returns the number of 
ouststanding locks on a project object. 





Property NextVersionNumber As String read- 
only Member of ReqPro40.Requirement 
Returns the next sequential version number for 
this requirement 


Sub Refresh() Member of ReqPro40.View Any 


Function GetPackage(IKey As Long, [eWeight 
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ePackageWeight Emptvl) As Package 
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Slot nan e 


SuspectDateTime 


Command 


ResetAllListltemValues 


PermissionsFor 


GetRootPackage 


VersionRev 


VersionMinor 


XMLVersion 


PersonalCatalog 


IsModified 


LastOpenedDateTime 


TracesTo 


Template Slots 


Member of ReqPro40.Project 


Property SuspectDateTime As String _ read- 
only Member of ReqPro40.Requirement 
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String 


Function Command([vOne], [vT wo], [vThree]) 
Member of ReqPro40.Project Generic 
Interface for providing additional functionality. 


Sub ResetAlIListItem Values(bSelected As 
Boolean) Member of RegPro40.AttrValue 
Selects or deselects all list item values. If the 
current user doesn't have update permissions 
for any list item values, then none of the list 
item values will be reset. 


Property PermissionsFor(ePermissionFor As 
enumPermissionTypes) As enumPermissions 
read-only Member of ReqPro40.Requirement 
Returns the permissions for the currently 


logged in user for the permission type 
specified. The ReqType, ReqTraceability and 
ReqText permission types are valid types for 
this interface. 


Function GetRootPackage([bLoadAl]Packages 
As Boolean = False]) As RootPackage 
Member of ReqPro40.Project 


Property VersionRev As Long read-only 
Member of ReqPro40.Application Returns 
the version revision number 


String 


Property VersionMinor As Long _ read-only 
Member of ReqPro40.Application Returns 
the minor version number of the application 


String 





Property XMLVersion As Long _ read-only 
Member of ReqPro40.Project 





Property PersonalCatalog As Catalog _ read- 
only Member of ReqPro40.Application 
Returns the local Catalog object 


Property IsModified As Boolean read-only 
Member of ReqPro40.Views Returns whether 
any of the Views in the collection have been 
modified 





Property LastOpenedDateTime As String 


read-only Member of ReqPro40.CatalogItem pining 


Property TracesTo As Relationships _ read- 
only Member of ReqPro40.Requirement 


Returns a Relationship object for the specified 
traces to object 
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Slot nan e 


PermissionsForDocType 


Level 


Rank 


Label 


ExtendedHelp 


ValidPackage_ 


GetRequirementsCount 


UserGroupKey 


Children 


GetDiscussions 


OpenProjectProperties 


Template Slots 


Property 
PermissionsForDocType(IDocTypeKey As 
Long) As enumPermissions — read-only 
Member of ReqPro40.Project Returns the 
current user's permissions for editing the 
Documents of the Document type (data). 
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Property Level As Long read-only Member 
of ReqPro40.Requirement Returns the 


hierarchical level of this requirement 


read-only Member of 
ReqPro40.ListItemValue Returns the rank of 
the list item associated with this list item value 


Property Label As String Member of 
ReqPro40.Attr Returns or sets the attribute's 
label value 


Sub ExtendedHelp(sProduct As String, 
sSubTool As String, sItem As String, 
sOperation As String, sQuery As String) 
Member of ReqPro40.Application Launches 
Rational Extended Help 


Function ValidPackage_(IKey As Long) As 
Boolean Member of ReqPro40.Project 


Function 
GetRequirementsCount(vReqsLookupValue, 
[eReqsLookupType As 
enumRequirementsLookups = 
eReqsLookup_ReqTypeKey]) As Long 
Member of ReqPro40.Project Returns the 
count of records returned by a query. 











Property UserGroupKey As Long _ read-only 
Member of ReqPro40.Project Returns the 
group of the current user 


Property Children As Relationships read-only 
Member of ReqPro40.Requirement Returns a 
collection of Relationship objects representing 
the children of this requirement 





Function GetDiscussions() As Discussions 
Member of ReqPro40.Requirement Returns 
the Discussions object associated with this 
requirement 


String 





unction 
OpenProjectProperties(vOpenProjOption Value, 


[eOpenProjOptionType As String 


enumOpenProjectOptions = 
eOpenProjOpt_RQSFile]) As Properties 
Member of ReqPro40.Application Opens a 
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Slot nan e 


LockCount 


CloseServer 


SecurityEnabled 


AuthorID 


PermissionsForReqType 


VersionDBSchema 


GetDiscussionItem 


LockProject 


UnlockProject 


TraceFrom 


DBState 


DataType 


Template Slots 


RequisitePro project and returns its properties 
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Property LockCount As Long read-only 
Member of ReqPro40.Project Returns the 


n 
= 
a. 
5 
aq 


number of outstanding locks against the 
Project. 


Sub CloseServer() Member of 
ReqPro40.Application Reserved 





> 
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Property SecurityEnabled As Boolean 
Member of ReqPro40.Project Returns or sets 
whether security is enabled for the project 


Boolean 





Property AuthorID As Long _ read-only 
Member of ReqPro40.Project 


Property 
PermissionsForReqType(IReqTypeKey As 
Long) As enumPermissions — read-only 
Member of ReqPro40.Project Returns the 
current user's permissions for editing the 
requirements of the requirement type (data). 


Property VersionDBSchema As Long | read- 
only Member of ReqPro40.Project Returns 
the database schema version number 


String 


Function GetDiscussionItem(IKey As Long) As 
Object Member of ReqPro40.Project 
Returns the specified discussion or response 


Function LockProject(vProjLookup Value, 
[eProjLookuptype As enumProjectLookups]) 
As String Member of ReqPro40.Application 
Locks a specific open project. 


Sub UnlockProject(sGUID As String, 
vProjLookupValue, [eProjLookuptype As 
enumProjectLookups]) Member of 
ReqPro40.Application Removes a lock from a 
specific project. 





Property TraceFrom(vRelLookupValue, 
[eRelLookupType As 
enumRelationshipLookups = 
eRelLookup_DerivedKey]) As Relationship 
read-only Member of ReqPro40.Requirement 
Returns the Relationship object for the 
specified traced from object 


String 


Property DBState As String read-only 
Member of ReqPro40.Requirement Returns 
the state of the object in the underlying 
datasource. 


String 
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Property DataType As enumAttrDataTypes String 
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Template Slots 


read-only Member of 
ReqPro40.ListItemValue Returns the data 
type of the attribute associated with the list item 
value 
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Property SequenceKey As Long _ read-only 
Member of ReqPro40.Project Returns the 

SequenceKey | sequence key for the project. The sequence key 
is an incrementing number assigned as a project 
is opened. 


String 


Property IsPermittedFor(ePermission As 
enumPermissions, ePermissionFor As 
enumPermissionTypes) As Boolean read-only 
Member of ReqPro40.Requirement Returns 

IsPermittedFor | whether the specified permissions are permitted 
for the specified permission type for the 
currently logged in user. The ReqType, 
ReqTraceability and ReqText permission types 
are valid types for this interface 


Boolean 


Property HasParent({ICount As Long]) As 
Boolean read-only Member of 
ReqPro40.Requirement Returns whether this 
requirement has a parent 


HasParent 





Property 
PermissionsForReqName(IReqTypeKey As 
Long) As enumPermissions — read-only 
Member of ReqPro40.Project 


PermissionsForReqName 





Property EventRaiseEnabled As Boolean 
EventRaiseEnabled |Member of ReqPro40.Application Returns or 
sets whether the server raises server events 


Boolean 





Property IsOpenedExclusive As Boolean 
read-only Member of ReqPro40.Project 
Returns whether the current user has opened the 
project exclusively 


. Property SetExclusiveAccess As Boolean 
SetExclusiveAccess Member of ReqPro40.Project Boolean 
Function GetCurrentUsers() As Properties . 
GetCurrentUsers Member of ReqPro40.Project String 


Function Query Validate(eQueryBaseType As 
enumQueryBaseTypes, eQueryFormat As 
enumQueryFormats, sQueryString As String, 
[oQueryDef As Object]) As Long Member of 
ReqPro40.Project Checks the specified query 


IsOpenedExclusive 





QueryValidate 


for correct syntax 


Function 
GetRequirements | GetRequirements(vReqsLookup Value, 
[eReqsLookupType As 


180 


n n wo n wo 
5. 5. 2 gq. 2 
é & S & =~ 
pat) pat) 
i=} i=} 





Slot nan e 


Child 


Flags 


IsOpenedReadOnly 


HasTracesTo 


PersonalCatalogltem 


IsAutoSuspect 


PublishAction 


Template Slots 


enumRequirementsLookups = 
eReqsLookup_ReqTypeKey], [eWeight As 
enumRequirementsWeights = 
eReqWeight_Medium], [eFlags As 

enum RequirementFlags], [IPageSize As Long = 
1000], [IPages As Long = 2]) As Requirements 
Member of ReqPro40.Project Returns the 
requirements in the project 


Property Child(vRelLookupValue, 
[eRelLookupType As 
enumRelationshipLookups = 
eRelLookup_DerivedKey]) As Relationship 
read-only Member of ReqPro40.Requirement 
Returns the Relationship object for the 
specified child of this requirement 
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String 


Property Flags As enumRequirementFlags 
read-only Member of ReqPro40.Requirement 
Returns the EnumRequirementFlags object 
associated with this requirement 





Property IsOpenedReadOnly As Boolean 
read-only Member of ReqPro40.Project 
Returns whether the current user has opend the 
project read only 


Property HasTracesTo([lCount As Long]) As 
Boolean read-only Member of 
ReqPro40.Requirement Returns whether this 
requirement has any traces to other 
requirements. Optionally returns the number of 
these traces. 


Property 
PersonalCatalogItem(vCatLookupValue, 
[eCatLookupType As enumCatalogLookups = 
eCatLookup_Name]) As CatalogItem _ read- 
only Member of ReqPro40.Application 
Returns the specified catalog item from the 
Local catalog collection 


String 


Property IsAutoSuspect As Boolean _ read- 
only Member of ReqPro40.AttrValue 
Returns whether changes to the attribute value 
will cause traceability relations to be suspect 


Sub PublishAction(eEventType As 
enumEventTypes, eObjectType As 
enumInterfaceIdentifiers, sGUID As String, 





String 


vEventData, eEventDataType As 
enumEventDataTypes, eEventSubType As 
enumEventSubTypes) Member of 
ReqPro40.Application 
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Template Slots 


Function GetCurrentProjectUsers(sRQSPath As 
GetCurrentProjectUsers | String) As Properties Member of 
ReqPro40.Application 
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Property Version As String read-only 
Version | Member of ReqPro40.Application Returns 
the version of the application 


String 


Function Display(eDisplayMode As 
enumDisplayModes, eDisplayType As 
enumDisplayTypes) As Object Member of 
ReqPro40.Requirement This method will 
display a requirement dialog of the mode and 
type received. 


Display 


Property IsNew As Boolean _ read-only 
IsNew | Member of ReqPro40.Requirement Indicates 
if the requirement is not new. 


Boolean 


Function Compare VersionNumber(sNumber1 
As String, sNumber2 As String) Member of 
ReqPro40.Application Compares version 
numbers 


CompareVersionNumber 


Property CustomTypes As CustomTypes 
oCustomTypes | read-only Member of ReqPro40.Application 
Reserved for future use. 


Property IsRoot As Boolean read-only 
IsRoot| Member of ReqPro40.Requirement Returns 
whether this requirement is a root requirement 


Sub Save() Member of ReqPro40. Views 
Save | Save all Views that have changed to the 
database 


Boolean 
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Property SelectedListItemValue As 
ListItemValue read-only Member of 
ReqPro40.AttrValue Returns the list item that 
is selected 


SelectedListItemValue 


Property RQSFilepath As String read-only 
ROQSFilepath |Member of ReqPro40.Project Returns the 
pathname of the .rqs file 


Property IsServerOpen As Boolean _ read-only 
IsServerOpen | Member of ReqPro40.Application 
Determines whether the server is running 


CLASS RELATIONSHIPS 
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Template Slots 


Property RQSFilepath As String read-only 
String 


Slot nan e 










RQSFilepath |Member of ReqPro40.Project Returns the 
pathname of the .rqs file 
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Template Slots 





Slot nan e 


Tag 


UnlockProject 


LogRelationshipRevisions 


GetCurrentRelationship 


PersonalCatalog 


Refresh 


PermissionsForListItemType 


IsInDB 


DropObjects 


IsValidLock 


CloseS. Sub CloseServer() Member of r 
BON EL ReqPro40.Application Reserved ny 
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Property Tag([eTagFormat As enumTagFormat 
= eTagFormat_Tag]) As String read-only 
Member of ReqPro40.Requirement Returns 
the tag for this requirement 


String 


Sub UnlockProject(sGUID As String, 
vProjLookupValue, [eProjLookuptype As 
enumProjectLookups]) Member of 
ReqPro40.Application Removes a lock from a 
specific project. 


Property LogRelationshipRevisions As Boolean 
Member of ReqPro40.Project Returns or sets 
whether relationships are logged in Revisions 


Boolean 





Function GetCurrentRelationship() As 
Relationship Member of 
ReqPro40.Relationships Returns the 
Relationship object at the current cursor 
position 


Property PersonalCatalog As Catalog _ read- 
only Member of ReqPro40.Application 
Returns the local Catalog object 


Sub Refresh() Member of ReqPro40.View Any 


Property 
PermissionsForListItemType(IReqTypeKey As 
Long, lAttrKey As Long, IListItemKey As 
Long) As enumPermissions — read-only 
Member of ReqPro40.Project Returns the 
current user's permissions for editing the 
ListItemValue of the ListItem type (data). 
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Property IsInDB(IKey As Long, eInterfaceID 
As enumInterfaceldentifiers, [sVersionNumber 
As String]) As Boolean read-only Member 
of ReqPro40.Project Returns whether the 


specified object is in the database 


Sub DropObjects(eInterfaceID As 
enumInterfaceldentifiers) Member of 
ReqPro40.Project Removes collections from 
the Project object 


Property IsValidLock(sGUID As String, 
vProjLo okupValue, [eProjLookuptype As 
enumProjectLookups]) As Boolean read-only 
Member of ReqPro40.Application Returns 
whether the supplied GUID represents a valid 
lock. 


String 
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Slot nan e 


RefreshSecurity 


PermissionsForAttr 


NewReqProCollection 


IsLocked 


AuthorID 


ValidPackage_ 


IsCurrentUserAdmin 


LockCount 


UserKey 


VersionDBSchema 


IsOpenedExclusive 


MoveFirst 


TraceTo 




















Template Slots 
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Sub RefreshSecurity() Member of 
ReqPro40.Project Retrieves current security 
information from the database 


String 


Property PermissionsForAttr(IReqTypeKey As 
Long, lAttrKey As Long) As enumPermissions 
read-only Member of ReqPro40.Project 
Returns the current user's permissions for 
editing the AttrValues of the Attr type (data). 


String 


Property NewReqProCollection As 
ReqProCollection read-only Member of 
ReqPro40.Project Returns a new 
ReqProCollection object. 


Property IsLocked As Boolean _ read-only 
Member of ReqPro40.Project Returns a value 
indicating whether or not the Project is locked. 


Boolean 


Property AuthorID As Long _ read-only 
Member of ReqPro40.Project 


Function ValidPackage_(IKey As Long) As 
Boolean Member of ReqPro40.Project 


Property IsCurrentUserAdmin As Boolean 
read-only Member of ReqPro40.Project 
Returns whether the current user has 
administrative permissions 


Property LockCount As Long read-only 
Member of ReqPro40.Project Returns the 
number of outstanding locks against the 
Project. 


Property UserKey As Long _ read-only 
Member of ReqPro40.Project Returns the key 
of the current user 


String 


Property VersionDBSchema As Long _ read- 
only Member of ReqPro40.Project Returns 
the database schema version number 


String 


Property IsOpenedExclusive As Boolean 
read-only Member of ReqPro40.Project 
Returns whether the current user has opened the 
project exclusively 


Sub MoveFirst() Member of ReqPro40. Views 
Sets the current position in the collection to the |Any 
first item 
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Property TraceTo(vRelLookupValue, 
[eRelLookupType As 


enumRelationshipLookups = 
eRelLookup_DerivedKey]) As Relationship 
read-only Member of ReqPro40.Requirement 
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Slot nan e 


MoveLast 


QueryFetch 


VersionMinor 


PermissionsForReqText 


GetRequirement 


LockProject 


ItemCurrent 


Child 


SecurityEnabled 


Version 


Template Slots 


Returns a Relationships object representing all 
of the objects to which this requirement traces 
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Sub MoveLast() Member of ReqPro40.Views 
Sets the current position in the collection to the | Any 
last item 


Function QueryFetch(eQueryBaseType As 
enumQueryBaseTypes, eQueryFormat As 
enumQueryFormats, sQueryString As String, 
[oQueryDef As Object]) Member of 
ReqPro40.Project Executes the specified 


query 
Property VersionMinor As Long _ read-only 


Member of ReqPro40.Application Returns 
the minor version number of the application 





Property 
PermissionsForReqText(IReqTypeKey As 
Long) As enumPermissions — read-only 
Member of ReqPro40.Project 


Function GetRequirement(vReqLookupValue, 
[eReqLookupType As 
enumRequirementLookups = 
eReqLookup_Key], [eWeight As 
enumRequirementsWeights = 
eReqWeight_Medium], [eFlags As 
enumRequirementFlags]) As Requirement 
Member of ReqPro40.Project Returns the 
object for the specified requirement 





Function LockProject(vProjLookup Value, 
[eProjLookuptype As enumProjectLookups]) 
As String Member of ReqPro40.Application 
Locks a specific open project. 
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Property ItemCurrent As Document read-only 
Member of ReqPro40.Views Returns the 
Document associated with the current item 


Property Child(vRelLookupValue, 

[eRelLookupType As 

enumRelationshipLookups = 
eRelLookup_DerivedKey]) As Relationship String 
read-only Member of ReqPro40.Requirement 
Returns the Relationship object for the 

specified child of this requirement 
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Property SecurityEnabled As Boolean 
Member of ReqPro40.Project Returns or sets 
whether security is enabled for the project 


Boolean 





Property Version As String read-only 
Member of ReaPro40.Application Returns 
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Slot nan e 


NextVersionNumber 


MovePrevious 


QueryValidate 


PermissionsForReqType 


GetPackage 


Display 


DocSaveFormat 


DBProperties 


TracesFrom 


PWD 


Template Slots 


the version of the application 
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Property NextVersionNumber As String _ read- 
only Member of ReqPro40.Requirement 
Returns the next sequential version number for 
this requirement 


String 


Sub MovePrevious() Member of 
ReqPro40.Views Set the current position in 
the collection to the previous item 


Function Query Validate(eQueryBaseType As 
enumQueryBaseTypes, eQueryFormat As 
enumQueryFormats, sQueryString As String, 
[oQueryDef As Object]) As Long Member of 
ReqPro40.Project Checks the specified query 
for correct syntax 


Property 
PermissionsForReqType(IReqTypeKey As 
Long) As enumPermissions — read-only 
Member of ReqPro40.Project Returns the 
current user's permissions for editing the 
requirements of the requirement type (data). 


Function GetPackage(IKey As Long, [eWeight 
As enumPackageWeights = 
ePackageWeight_Empty]) As Package 
Member of ReqPro40.Project 


Function Display(eDisplayMode As 
enumDisplayModes, eDisplayType As 
enumDisplayTypes) As Object Member of 
ReqPro40.Requirement This method will 
display a requirement dialog of the mode and 
type received. 


Property DocSaveFormat As 
enumDocSaveFormat Member of 
ReqPro40.Project Returns the document save 
format 





Property DBProperties As Object read-only 
Member of ReqPro40.Project Returns the 
properties for the project 


String 


Property TracesFrom As Relationships _read- 
only Member of ReqPro40.Requirement 
Returns a Relationships object representing all 
of the objects from which this requirement 
traces 


String 


Property PWD As String Member of 
ReqPro40.Application Sets a default 
password 


String 
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Template Slots 





Slot nan e 


IsRoot 


IsDocBased 


DBState 


TraceFrom 


DeleteRequirementHierarchy 


HasParent 


Bookmark 


Delete 


HasTracesTo 


Property IsRoot As Boolean read-only 
Member of ReqPro40.Requirement Returns 
whether this requirement is a root requirement 
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Boolean 


Property IsDocBased As Boolean _ read-only 
Member of ReqPro40.Requirement Returns 
whether this requirement lives in a document 


Property DBState As String read-only 
Member of ReqPro40.Requirement Returns 
the state of the object in the underlying 
datasource. 





Property TraceFrom(vRelLookupValue, 
[eRelLookupType As 
enumRelationshipLookups = 
eRelLookup_DerivedKey]) As Relationship 
read-only Member of ReqPro40.Requirement 


String 


Returns the Relationship object for the 
specified traced from object 


Sub DeleteRequirementHierarchy([eDeleteFlag 
As enumRequirementDeleteFlags = 
eReqDelFlag_Empty], 
[vNewParentLookupValue], 
[vNewParentLookupType As 
enumRequirementLookups = 
eReqLookup_Key]) Member of 
ReqPro40.Requirement Deletes a requirement 
from the project and provides options for 
dealing with hierarchical children. 


Property HasParent({ICount As Long]) As 
Boolean read-only Member of 
ReqPro40.Requirement Returns whether this 
requirement has a parent 





Property Bookmark As String read-only 
Member of ReqPro40.Requirement Returns 
the bookmark associated with this requirement 
(if any) 


Sub Delete(vViewLookupValue, 

[eViewLookupType As enumViewLookups = 
eViewLookup_Key]) Member of ny 
ReqPro40.Views Deletes the specified view 

from the project 


String 
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Property HasTracesTo([lCount As Long]) As 
Boolean read-only Member of 
ReqPro40.Requirement Returns whether this 


requirement has any traces to other 
requirements. Optionally ret urns the number of 
these traces. 
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Slot nan e 


HasTracesFrom 


Count 


VersionMajor 


PermissionsForReqName 


IsEOF 


IsOpenedReadOnly 


Save 


PersonalCatalogltem 


CompareVersionNumber 


IsPermittedFor 


Template Slots 


Property HasTracesFrom([{ICount As Long]) As 
Boolean read-only Member of 
ReqPro40.Requirement Returns whether this 
requirement has any traces from other 
requirements. Optionally returns the number of 
these traces. 





‘Cardinality 


Property Count As Long read-only Member 
of ReqPro40.Views Returns the number of 
View objects in the collection 


Property VersionMajor As Long _ read-only 
Member of ReqPro40.Application Returns 
the major version number of the application 


String 


Property 
PermissionsForReqName(IReqTypeKey As 
Long) As enumPermissions — read-only 
Member of ReqPro40.Project 


Property ISEOF As Boolean read-only 
Member of ReqPro40.Views Returns whether 
the end of the collection has been reached 


Property IsOpenedReadOnly As Boolean 
read-only Member of ReqPro40.Project 
Returns whether the current user has opend the 
project read only 


Sub Save() Member of ReqPro40.Views 
Save all Views that have changed to the 
database 
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Property 

PersonalCatalogItem(vCatLookup Value, 
[eCatLookupType As enumCatalogLookups = 
eCatLookup_Name]) As CatalogItem read- {String 
only Member of ReqPro40.Application 

Returns the specified catalog item from the 

Local catalog collection 


Function Compare VersionNumber(sNumber1 
As String, sNumber2 As String) Member of 
ReqPro40.Application Compares version 
numbers 


String 


Property IsPermittedFor(ePermission As 
enumPermissions, ePermissionFor As 
enumPermissionTypes) As Boolean read-only 
Member of ReqPro40.Requirement Returns 
whether the specified permissions are permitted 
for the specified permission type for the 
currently logged in user. The ReqType, 
ReqTraceability and ReqText permission types 
are valid types for this interface 


Boolean 
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Slot nan e 


IsInKeyset 


Suspect 


OpenProjectProperties 


UserGroupKey 


Item 


RelationshipType 


ProjectLockCount 


Action 


IsProjectOpen 


CreateRequirement 


Template Slots 


Property IsInKeyset(IKey As Long) As 
Boolean read-only Member of 
ReqPro40.Views Returns whether the 
specified key is in the collection 
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Boolean 


Property Suspect As Boolean Member of 
ReqPro40.Relationships Sets all Relationship 
objects in the collection to suspect 


Boolean 


unction 
OpenProjectProperties(vOpenProjOption Value, 
[eOpenProjOptionType As 
enumOpenProjectOptions = 
eOpenProjOpt_RQSFile]) As Properties 
Member of ReqPro40.Application Opens a 
RequisiteP ro project and returns its properties 


Property UserGroupKey As Long _ read-only 
Member of ReqPro40.Project Returns the 
group of the current user 
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Property Item(v ViewLookupValue, 
[eViewLookupType As enumViewLookups = 
eViewLookup_Key]) As View _ read-only 
Default member of ReqPro40.Views Returns 
the specified View 
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Property RelationshipType As 
enumRelationshipTypes read-only Member 
of ReqPro40.Relationships Returns an 
enumerated value indicating the type of the 
Relationship objects in this collection 


Property 
ProjectLockCount(vProjLookupValue, 
[eProjLookuptype As enumProjectLookups]) 
As Long read-only Member of 
ReqPro40.Application Returns the number of 
ouststanding locks on a project object. 


n n 
= = 
a. zs 
5 5 
ie) ga 


Event Action(eEventType As 
enumEventTypes, eObjectType As 
enumInterfaceIdentifiers, sGUID As String, 
vEventData, eEventDataType As 
enumEventDataTypes, eEventSubType As 
enumEventSubTypes, sTimestamp As String) 
Member of ReqPro40.Application 


> 


ny 


Property IsProjectOpen As Boolean _ read-only 
Member of ReqPro40.Project Returns 
whether the current user has the project open 


Function CreateRequirement(sName As String, 
sText As String, VReqTypeLookupValue, 
[eReqTypeLookupType As 


String 
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Slot nan e 


GetRequirements 


WeightName 


IsBOF 


GetDiscussionItem 


MoveNext 


GetCurrentUsers 


IsProjectLocked 


DirectionName 


RelationshipTypeName 


Template Slots 


enumReqTypesLookups = 
eReqTypesLookups_Key], [sVersionLabel As 
String], [sVersionReason As String], 
[vParentReqLookupValue], 
[eParentReqLookupType As 
enumRequirementLookups = 
eReqLookup_Empty]) As Requirement 
Member of ReqPro40.Project 





‘Cardinality 


Function 
GetRequirements(vReqsLookupValue, 
[eReqsLookupType As 
enumRequirementsLookups = 
eReqsLookup_ReqTypeKey], [eWeight As 
enumRequirementsWeights = 
eReqWeight_Medium], [eFlags As 
enumRequirementFlags], [IPageSize As Long = 
1000], [IPages As Long = 2]) As Requirements 
Member of ReqPro40.Project Returns the 
requirements in the project 


Property WeightName As String read-only 
Member of ReqPro40.Requirement Returns a 
string representation of the weight of this object 


String 


n 
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Property IsBOF As Boolean read-only 
Member of ReqPro40.Views Returns whether 
the current position represents the beginning of 





> 
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Function GetDiscussionItem([Key As Long) As 
Object Member of ReqPro40.Project 
Returns the specified discussion or response 
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Sub MoveNext() Member of 
ReqPro40.Views Set the current positionin |Any 
the collection to the next item 


Function GetCurrentUsers() As Properties Str 
Member of ReqPro40.Project mre 


Property IsProjectLocked(vProjLookup Value, 
[eProjLookuptype As enumProjectLookups]) 
As Boolean read-only Member of 
ReqPro40.Application Determines if a 
specific project has any outstanding locks. 





Property DirectionName As String read-only 
Member of ReqPro40.Relationships Returns 
the name of the direction of the relationship 
objects held by this collection (tracesto, 
tracesfrom, child, or parent) 





Property RelationshipTypeName As String 


read-only Member of ReqPro40.Relationships 


Returns the name of the Relationshin ohiects in 


String 
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Slot nan e 


Command 


GetRootPackage 


Text 


AutoSuspect 


ChangeLoggedInUser 


PermissionsForDocType 


AreProjectsLocked 


PermissionsFor 


AssignParent 


GetCurrentProjectUsers 


TracesTo 


Template Slots 


Function Command([vOne], [vT wo], [vThree]) 
Member of ReqPro40.Project Generic 
Interface for providing additional functionality. 





‘Cardinality 


Function GetRootPackage([bLoadAllPackages 
As Boolean = False]) As RootPackage 
Member of ReqPro40.Project 


Property Text As String Member of 
ReqPro40.Requirement Returns or sets the 
textual definition for this requirement 


String 


Property AutoSuspect As Boolean Member of 
ReqPro40.Project Returns or sets whether 
requirements are auto suspect 


Boolean 





Function ChangeLoggedInUser(v Value, 
[eUserLookup As enumUserLookups = 
eUserLookups_Key], [vValue2]) As Boolean 
Member of ReqPro40.Project Changes the 
user logged into the project. 


Boolean 





Property 
PermissionsForDocType(IDocTypeKey As 
Long) As enumPermissions — read-only 
Member of ReqPro40.Project Returns the 
current user's permissions for editing the 
Documents of the Document type (data). 





Property AreProjectsLocked As Boolean 
read-only Member of ReqPro40.Application 


Property PermissionsFor(ePermissionFor As 
enumPermissionTypes) As enumPermissions 
read-only Member of ReqPro40.Requirement 
Returns the permissions for the currently 
logged in user for the permission type 
specified. The ReqType, ReqTraceability and 
ReqText permission types are valid types for 
this interface. 


Function AssignParent(vReqLookupValue, 
[eReqLookupType As 
enumRequirementLookups = 
eReqLookup_Key]) As Requirement Member 
of ReqPro40.Requirement Changes the 
requirement's parent or sets the it to the root 
level. 


String 





Function GetCurrentProjectUsers(sRQSPath As 


String) As Properties Member of 
ReqPro40.Application 


Property TracesTo As Relationships read- String 
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String 
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Template Slots 


‘Cardinality 


only Member of ReqPro40.Requirement 


Returns a Relationship object for the specified 
traces to object 





Property SuspectDateTime As String _ read- 


HuspentDaleT ene only Member of ReqPro40.Requirement 


String 
Property XMLVersion As Long _ read-only 


AME Nerovon Member of ReqPro40.Project 


Property CurrentDerivedKey As String _ read- 
only Member of ReqPro40.Relationships 
Returns the derived key of the Relationship 
pointed to by CurrentPosition() 


CurrentDerivedKey 


Property IsNew As Boolean _ read-only 
IsNew | Member of ReqPro40.Requirement Indicates 
if the requirement is not new. 


Property DocPosition As Long _ read-only 
Member of ReqPro40.Requirement Returns 
the position of the requirement wit hin the 
document. 


DocPosition 


Property SequenceKey As Long _ read-only 
Member of ReqPro40.Project Returns the 

SequenceKey | sequence key for the project. The sequence key 
is an incrementing number assigned as a project 
is opened. 


String 


Property Children As Relationships read-only 
Member of ReqPro40.Requirement Returns a 
collection of Relationship objects representing 
the children of this requirement 


Children 


Property EventRaiseEnabled As Boolean 
EventRaiseEnabled |Member of ReqPro40.Application Returns or 
sets whether the server raises server events 


Property IsModified As Boolean read-only 
Member of ReqPro40.Views Returns whether 
any of the Views in the collection have been 
modified 


IsModified 


Sub Revert([bRevertAll As Boolean = False]) 
Revert | Member of ReqPro40.Views _ Restores objects 
to their state when originally created 


Boolean 





Property DocKey As Long _ read-only 
Member of ReqPro40.Requirement Returns 
the key for the Document object associated 
with this requirement (if any) 


DocKey String 





Property CustomTypes As CustomTypes 
oCustomTypes | read-only Member of ReqPro40.Application 
Reserved for future use. 


String 
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Template Slots 





Slot nan e 


ExtendedHelp 


PermissionsForReqTraceability 


Flags 


SetExclusiveAccess 


Add 


PublishAction 


GetRequirementsCount 


Level 


GetDiscussions 


‘Cardinality 


Sub ExtendedHelp(sProduct As String, 
sSubTool As String, sItem As String, 
sOperation As String, sQuery As String) 
Member of ReqPro40.Application Launches 
Rational Extended Help 


String 


Property 
PermissionsForReqTraceability(IReqr ypeKey 
As Long) As enumPermissions — read-only 
Member of ReqPro40.Project Returns the 
current user's permissions for editing the 
traceability of requirements of the requirement 
type (data). 


String 


Property Flags As enumRequirementFlags 
read-only Member of ReqPro40.Requirement 
Returns the EnumRequirementFlags object 
associated with this requirement 


Property SetExclusiveAccess As Boolean Bool 
Member of ReqPro40.Project pais 


Function Add(sName As String, eViewType As 
enumViewTypes, sPrimaryQueryString As 
String, ePrimaryQueryStringFormat As 
enumQueryFormats, [sSecondaryQueryString 
As String], [eSecondaryQueryStringFormat As 
enumQueryFormats], [sPropertyString As 
String], [sDescription As String], 
[sVersionReason As String], [eViewVisibility 
As enumViewVisibility = 1]) As View 
Member of ReqPro40.Views Adds the 
specified view to the collection 


Sub PublishAction(eEventType As 
enumEventTypes, eObjectType As 
enumlInterfaceldentifiers, sGUID As String, 
vEventData, eEventDataType As 
enumEventDataTypes, eEventSubType As 
enumEventSubTypes) Member of 
ReqPro40.Application 


String 





Function 
GetRequirementsCount(vReqsLookupValue, 
[eReqsLookupType As 
enumRequirementsLookups = 
eReqsLookup_ReqTypeKey]) As Long 
Member of ReqPro40.Project Returns the 
count of records returned by a query. 


String 





Property Level As Long read-only Member 


of ReqPro40.Requirement Returns the 
hierarchical level of this requirement 


Function GetDiscussions() As Discussions String 
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String 
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Template Slots 





Member of ReqPro40.Requirement Returns 
the Discussions object associated with this 
requirement 


Property IsServerOpen As Boolean _ read-only 
IsServerOpen | Member of ReqPro40.Application 
Determines whether the server is running 


Property CurrentPosition As Long Member of 
CurrentPosition | ReqPro40.Views _ Returns or sets the current 
cursor position within the collection 


Property VersionRev As Long _ read-only 
VersionRev | Member of ReqPro40.Application Returns 
the version revision number 


CLASS RELATIONSHIP 





Template Slots 


Slot nan e Documentation 





Type | Cardinality 


Function GetCurrentProjectUsers(sRQSPath As 
GetCurrentProjectUsers | String) As Properties Member of 
ReqPro40.Application 


String 0:1 


Property ItemCurrent As Document read-only 
ItemCurrent| Member of ReqPro40.Views Returns the 
Document associated with the current item 


0:1 
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Function CompareVersionNumber(sNumber1! As 
CompareVersionNumber | String, sNumber2 As String) Member of 
ReqPro40.Application Compares version numbers 


String 0:1 


Property Tag({eTagFormat As enumTagFormat = 
eTagFormat_Tag]) As String read-only Member 
of ReqPro40.Requirement Returns the tag for this 
requirement 


Tag String 0:1 


Property IsLocked As Boolean — read-only 
IsLocked | Member of ReqPro40.Project Returns a value 
indicating whether or not the Project is locked. 


Boolean | 0:1 


Property AutoSuspect As Boolean Member of 
AutoSuspect | ReqPro40.Project Returns or sets whether 
requirements are auto suspect 


Boolean | 0:1 


Property Child(vRelLookupValue, 
[eRelLookupType As enumRelationshipLookups = 
eRelLookup_Deriv edKey]) As Relationship — read- 
only Member of ReqPro40.Requirement Returns 
the Relationship object for the specified child of this 
requirement 


Child String 0:1 


Property DocSaveFormat As enumDocSaveFormat 
DocSaveFormat | Member of ReqPro40.Project Returns the 
document save format 


String 0:1 





194 


Template Slots 


Property RQSFilepath As String read-only 
RQSFilepath | Member of ReqPro40.Project Returns the 
pathname of the .rqs file 


String 0:1 


Property IsProjectOpen As Boolean read-only 
IsProjectOpen | Member of ReqPro40.Project Returns whether the 
current user has the project open 


Boolean | 0:1 


Sub PublishAction(eEventType As 
enumEventTypes, eObjectType As 
enumInterfaceldentifiers, sGUID As String, 
PublishAction | vVEventData, eEventDataType As 
enumEventDat aTypes, eEventSubType As 
enumEventSubTypes) Member of 
ReqPro40.Application 


String 0:1 


Function Query Validate(eQueryBaseType As 
enumQueryBaseTypes, eQueryFormat As 
enumQueryFormats, sQueryString As String, 
[oQueryDef As Object]) As Long Member of 
ReqPro40.Project Checks the specified query for 
correct syntax 


Sub Revert([bRevertAll As Boolean = False]) 
Revert | Member of RegPro40.Views Restores objects to 
their state when originally created 


Query Validate String 0:1 


Boolean | 0:1 


Property VersionDBSchema As Long _ read-only 
VersionDBSchema | Member of ReqPro40.Project Returns the database 
schema version number 


String 0:1 


Property LockCount As Long _ read-only 
LockCount | Member of ReqPro40.Project Returns the number 
of outstanding locks against the Project. 





String 0:1 





Property DocKey As Long read-only Member of 
ReqPro40.Requirement Returns the key for the 
Document object associated with this requirement 
(if any) 


DocKey String 0:1 


Property SourceRelKey As Long _ read-only 
Member of ReqPro40.Relationship Returns the 
key of the relationship in the project of the source 
Requirement. 


SourceRelKey String 0:1 


Property RelationshipType As 
enumRelationshipTypes read-only Member of 

RelationshipType | ReqPro40.Relationships Returns an enumerated 
value indicating the type of the Relationship objects 
in this collection 


String 0:1 


Property Flags As enumRequirementFlags _ read- 
only Member of ReqPro40.Requirement Returns 
the EnumRequirementFlags object associated with 
this requirement 


Flags String 0:1 
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Template Slots 


Soredasiedecses EEO ahy Dele XCHISIENOCES As Boolean Member Beslean Osi 
of ReqPro40.Project 


Property SourceRequirement([eWeight As 

enumRequirementsWeights = eReqWeight_Empty]) 
SourceRequirement| As Requirement read-only Member of String 0:1 

ReqPro40.Relationship Returns the source 

Requirement object 


Property Version As String read-only Member 
Version | of ReqPro40.Application Returns the version of 
the application 


String 0:1 


Property HasTracesFrom([{ICount As Long]) As 
Boolean read-only Member of 

HasTracesFrom | ReqPro40.Requirement Returns whether this 
requirement has any traces from other requirements. 
Optionally returns the number of these traces. 


Boolean | 0:1 


Property SequenceKey As Long _ read-only 
Member of ReqPro40.Project Returns the 

SequenceKey | sequence key for the project. The sequence key is an 
incrementing number assigned as a project is 
opened. 


String 0:1 


Property SourceProject As Project read-only 
Member of ReqPro40.Relationship Returns the 
Project object associated with the source 
Requirement 


SourceProject String 0:1 


Function CreateRequirement(sName As String, 
sText As String, VReqTypeLookupValue, 
[eReqTypeLookupType As enumReqTypesLookups 
= eReqTypesLookups_Key], [sVersionLabel As 

CreateRequirement | String], [sVersionReason As String], 
[vParentReqLookup Value], 
[eParentReqLookupType As 
enumRequirementLookups = eReqLookup_Empty]) 
As Requirement Member of ReqPro40.Project 


String 0:1 





Event Action(eEventType As enumEventTypes, 
eObjectType As enumInterfaceldentifiers, sGUID 
As String, vEventData, eEventDataType As 
enumEventDataTypes, eEventSubType As 
enumEventSubTypes, sTimestamp As String) 
Member of ReqPro40.Application 


Action Any 0:1 


Property PersonalCatalog As Catalog read-only 
PersonalCatalog | Member of ReqPro40.Application Returns the 
local Catalog object 


String 0:1 


Property Level As Long read-only Member of 
Level | ReqPro40.Requirement Returns the hierarchical 
level of this requirement 


GetRootPackage | Function GetRootPackage([bLoadAllPackages As String 0:1 
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String 0:1 





Template Slots 


Boolean = False]) As RootPackage Member of 

ReqPro40.Project 

Property AuthorID As Long read-only Member . : 
AuaOrED of ReqPro40.Project Scring of 


Property CurrentDerivedKey As String — read-only 
Member of ReqPro40.Relationships Returns the 
derived key of the Relationship pointed to by 
CurrentPosition() 


Sub Delete(vViewLookupValue, 
[eViewLookupType As enumViewLookups = 
eViewLookup_Key]) Member of ReqPro40.Views 
Deletes the specified view from the project 


Sub UnlockProject(sGUID As String, 
vProjLookupValue, [eProjLookuptype As 

UnlockProject | enumProjectLookups]) Member of 
ReqPro40.Application Removes a lock from a 
specific project. 


Property IsValidLock(sGUID As String, 
vProjLookupValue, [eProjLookuptype As 
IsValidLock | enumProjectLookups]) As Boolean read-only 
Member of ReqPro40.Application Returns 
whether the supplied GUID represents a valid lock. 


CurrentDerivedKey String 0:1 


Delete 0:1 


> 
5 
< 


String 0:1 


String 0:1 


Property DestinationProject As Project read-only 
Member of ReqPro40.Relationship Returns the 
Project object associated with the destination 
Requirement 


DestinationProject String 0:1 


Function Command([vOne], [vT wo], [vThree]) 
Command | Member of ReqPro40.Project Generic Interface 
for providing additional functionality. 


String 0:1 


Property PermissionsForReqText(IReqTypeKey As 
PermissionsForReqText |Long) As enumPermissions read-only Member 
of ReqPro40.Project 


String 0:1 


unction 
OpenProjectProperties(vOpenProjOptionValue, 
[eOpenProjOptionType As 

OpenProjectProperties | enumOpenProjectOptions = 
eOpenProjOpt_RQSFile]) As Properties Member 
of ReqPro40.Application Opens a RequisitePro 
project and returns its properties 


String 0:1 


Property IsCrossProject As Boolean read-only 
Member of ReqPro40.Relationship Returns 
whether this Relationship object represent a cross 
project relationship 


IsCrossProject Boolean | 0:1 





Function GetPackage(IKey As Long, [eWeight As 


Gein ackage enumPackageWeights = ePackageWeight Emptvy]) 


String 0:1 
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Template Slots 


As Package Member of ReqPro40.Project = 
Property CustomTypes As CustomTypes _ read- 
oCustomTypes | only Member of ReqPro40.Application String 0:1 


Reserved for future use. 


Sub ExtendedHelp(sProduct As String, sSubTool 
As String, sItem As String, sOperation As String, 

ExtendedHelp | sQuery As String) Member of 
ReqPro40.Application Launches Rational 
Extended Help 


String 0:1 


Property PersonalCatalogItem(vCatLookup Value, 
[eCatLookupType As enumCatalogLookups = 
eCatLookup_Name]) As CatalogItem read-only 
Member of ReqPro40.Application Returns the 
specified catalog item from the Local catalog 
collection 


PersonalCatalogltem String 0:1 


Function 
GetRequirementsCount(vReqsLookupValue, 
[eReqsLookupType As enumRequirementsLookups 
= eReqsLookup_ReqTypeKey]) As Long Member 
of ReqPro40.Project Returns the count of records 
returned by a query. 


GetRequirementsCount String 0:1 


Property LogRelationshipRevisions As Boolean 
LogRelationshipRevisions | Member of ReqPro40.Project Returns or sets 
whether relationships are logged in Revisions 


Boolean | 0:1 


Property PermissionsForReqType(IReqTypeKey As 
Long) As enumPermissions read-only Member 

PermissionsForReqType | of ReqPro40.Project Returns the current user's 
permissions for editing the requirements of the 
requirement type (data). 


String 0:1 


Property HasParent([{ICount As Long]) As Boolean 
HasParent| read-only Member of ReqPro40.Requirement 
Returns whether this requirement has a parent 


Boolean | 0:1 





Property UserGroupKey As Long _ read-only 
UserGroupKey | Member of ReqPro40.Project Returns the group of 
the current user 


String 0:1 


Property TraceTo(vRelLookupValue, 
[eRelLookupType As enumRelationshipLookups = 
eRelLookup_DerivedKey]) As Relationship — read- 
only Member of ReqPro40.Requirement Returns 
a Relationships object representing all of the objects 
to which this requirement traces 


TraceTo String 0:1 


Property EventRaiseEnabled As Boolean Member 
EventRaiseEnabled | of ReqPro40.Application Returns or sets whether 
the server raises server events 


Boolean | 0:1 





VersionMajor | Property VersionMajor As Long _ read-only String 0:1 
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Template Slots 


Member of ReqPro40.Application Returns the 
major version number of the application 


Property IsCurrentUserAdmin As Boolean _ read- 
only Member of ReqPro40.Project Returns 
whether the current user has administrative 
permissions 


IsCurrentUserAdmin Boolean | 0:1 


Property RelatedRequirement(oLocalRequirement 
As Requirement, [eWeight As 
enumRequirementsWeights = eReqWeight_Empty]) 
As Requirement read-only Member of 
ReqPro40.Relationship Returns the Requirement 
object that is related to the specified requirement 


RelatedRequirement String 0:1 











Property CurrentPosition As Long Member of 
CurrentPosition | ReqPro40.Views Returns or sets the current cursor 
position within the collection 


0:1 
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Property PermissionsForDocType(IDocTypeKey As 

Long) As enumPermissions read-only Member 
PermissionsForDocType | of ReqPro40.Project Returns the current user's 

permissions for editing the Documents of the 


String 0:1 


Document type (data). 


Function LockProject(vProjLookupValue, 
[eProjLookuptype As enumProjectLookups]) As 
String Member of ReqPro40.Application Locks 
a specific open project. 


LockProject String 0:1 

















Property SourceKey As Long read-only Member 
SourceKey | of ReqPro40.Relationship Returns the key of the 
source Requirement 


String 0:1 


Property IsSEOF As Boolean read-only Member 
IsEOF | of ReqPro40.Views Returns whether the end of 
the collection has been reached 


Boolean | 0:1 


Function AssignParent(vReqLookupValue, 
[eReqLookupType As enumRequirementLookups = 

AssignParent | eReqLookup_Key]) As Requirement Member of 
ReqPro40.Requirement Changes the requirement's 
parent or sets the it to the root level. 


Function GetCurrentUsers() As Properties , . 
GetCurrentUsers Member of ReqPro40.Project String 0:1 


Property HasTracesTo([lCount As Long]) As 
Boolean read-only Member of 

HasTracesTo | ReqPro40.Requirement Returns whether this 
requirement has any traces to other requirements. 
Optionally returns the number of these traces. 


String 0:1 


Boolean | 0:1 


Property WeightName As String read-only 
WeightName | Member of ReqPro40.Requirement Returns a 
string representation of the weight of this object 


String 0:1 
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Sub RefreshSecurity() Member of 
RefreshSecurity | ReqPro40.Project Retrieves current security 
information from the database 


String 0:1 


Property DestinationRequirement([eWeight As 


enumRequirementsWeights = eReqWeight_Empty]) 

DestinationRequirement| As Requirement read-only Member of 
ReqPro40.Relationship Returns the destination 
Requirement object 


String 0:1 





Sub DeleteRequirementHierarchy([eDeleteFlag As 
enumRequirementDeleteFlags = 
eReqDelFlag_Empty], [VNewParentLookupValue], 
[vNewParentLookupType As 
enumRequirementLookups = eReqLookup_Key]) 
Member of ReqPro40.Requirement Deletes a 
requirement from the project and provides options 
for dealing with hierarchical children. 


DeleteRequirementHierarchy String 0:1 


Property SecurityEnabled As Boolean Member of 
SecurityEnabled | ReqPro40.Project Returns or sets whether security 
is enabled for the project 


Boolean | 0:1 





Property XMLVersion As Long _ read-only 


Nene Member of ReqPro40.Project 


String 0:1 
Property 
DestinationRequirementInfo(eRequirementInfoType 
As enumObjectInfoTypes) read-only Member of 
RegPro40.Relationship Returns basic destination 
Requirement info via direct SQL. Avoids loading 

the Requirement object. 


DestinationRequirementInfo String 0:1 


Property Count As Long read-only Member of 
Count) ReqPro40.Views Returns the number of View Any 0:1 
objects in the collection 


Property IsRoot As Boolean read-only Member 
IsRoot| of ReqPro40.Requirement Returns whether this 
requirement is a root requirement 


Boolean | 0:1 





Property IsInKeyset(IKey As Long) As Boolean 
IsInKeyset | read-only Member of ReqPro40.Views Returns 
whether the specified key is in the collection 


Boolean | 0:1 





Property TraceFrom(vRelLookup Value, 
[eRelLookupType As enumRelationshipLookups = 
eRelLookup_DerivedKey]) As Relationship — read- 
only Member of ReqPro40.Requirement Returns 
the Relationship object for the specified traced from 
object 


Sub MoveNext() Member of ReqPro40.Views 
MoveNext | Set the current position in the collection to the next | Any 0:1 
item 


TraceFrom String 0:1 
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Property IsModified As Boolean read-only 
IsModified | Member of ReqPro40.Views Returns whether any 
of the Views in the collection have been modified 


Boolean | 0:1 


Property Text As String Member of 
Text |ReqPro40.Requirement Returns or sets the textual 
definition for this requirement 


String 0:1 





Property UserKey As Long read-only Member 
UserKey | of ReqPro40.Project Returns the key of the current 
user 


String 0:1 


Property PermissionsForReqName(IReqTypeKey 
PermissionsForReqName | As Long) As enumPermissions — read-only 
Member of ReqPro40.Project 


String 0:1 





Property TracesTo As Relationships read-only 
TracesTo | Member of ReqPro40.Requirement Returns a 
Relationship object for the specified traces to object 


String 0:1 


Property SourceProjectGUID As String _ read-only 
SourceProjectGUID | Member of ReqPro40.Relationship Returns the 
Project GUID of the source Requirement. 


String 0:1 


Property NextVersionNumber As String read-only 
NextVersionNumber | Member of ReqPro40.Requirement Returns the 
next sequential version number for this requirement 


Property IsInDB(IKey As Long, eInterfaceID As 
enumInterfaceldentifiers, [sVersionNumber As 

IsInDB | String]) As Boolean read-only Member of 
ReqPro40.Project Returns whether the specified 
object is in the database 





String 0:1 


Boolean | 0:1 





Property DocPosition As Long _ read-only 
DocPosition | Member of ReqPro40.Requirement Returns the 
position of the requirement within the document. 


String 0:1 


Property IsOpenedExclusive As Boolean _ read- 
only Member of ReqPro40.Project Returns 
whether the current user has opened the project 
exclusively 


Sub DropObjects(eInterfaceID As 
enumInterfaceldentifiers) Member of 
ReqPro40.Project Removes collections from the 
Project object 


IsOpenedExclusive Boolean | 0:1 


DropObjects String 0:1 





Property 
RelatedRequirementInfo(oLocalRequirement As 
Requirement, eRequirementInfoType As 

RelatedRequirementInfo |enumObjectInfoTypes) read-only Member of 
ReqPro40.Relationship Returns basic related 
Requirement info via direct SQL. Avoids loading 
the Requirement object. 


SuspectDateTime | Property SuspectDateTime As String read-only String 0:1 
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String 0:1 





Template Slots 


Member of ReqPro40.Requirement = 


Property DBState As String read-only Member 
DBState | of ReqPro40.Requirement Returns the state of the | String 0:1 
object in the underlying datasource. 


Property IsOpenedReadOnly As Boolean _ read- 
only Member of ReqPro40.Project Returns 
whether the current user has opend the project read 
only 


IsOpenedReadOnly Boolean | 0:1 


Sub MovePrevious() Member of ReqPro40. Views 
MovePrevious | Set the current position in the collection to the 
previous item 


0:1 
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Property ProjectLockCount(vProjLookup Value, 
[eProjLookuptype As enumProjectLookups]) As 
ProjectLockCount|Long read-only Member of 
ReqPro40.Application Returns the number of 
ouststanding locks on a project object. 


Sub MoveLast() Member of ReqPro40.Views 
MoveLast | Sets the current position in the collection to the last | Any 0:1 
item 


String 0:1 


Property VersionMinor As Long _ read-only 
VersionMinor | Member of ReqPro40.Application Returns the 
minor version number of the application 


String 0:1 





Property DestinationProjectGUID As String _ read- 
DestinationProjectGUID | only Member of ReqPro40.Relationship Returns 
the Project GUID of the destination Requirement. 


String 0:1 


Property DerivedKey As String read-only 
Member of ReqPro40.Relationship Returns a 
unique key composed of the DestProjGUID + 
DestReqKey + SourceProjGUID + SourceReqKey. 


: Function ValidPackage_(IKey As Long) As . 
Validbackage.. Boolean Member of ReqPro40.Project Boea ee 


Property IsPermittedFor(ePermission As 
enumPermissions, ePermissionFor As 
enumPermissionTypes) As Boolean read-only 
Member of ReqPro40.Requirement Returns 

IsPermittedFor | whether the specified permissions are permitted for 
the specified permission type for the currently 
logged in user. The ReqType, ReqTraceability and 
ReqText permission types are valid types for this 
interface 


Property PWD As String Member of . . 
Pun ReqPro40.Application Sets a default password Sining mo 


Property IsBOF As Boolean read-only Member 
IsBOF | of ReqPro40.Views Returns whether the current 


DerivedKey String 0:1 





Boolean | 0:1 





> 
5 
“< 
S 
a 





position represents the beginning of 
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Template Slots 


Property PermissionsFor(ePermissionFor As 
enumPermissionTypes) As enumPermissions 
read-only Member of ReqPro40.Requirement 


PermissionsFor | Returns the permissions for the currently logged in | String 0:1 
user for the permission type specified. The 
ReqType, ReqTraceability and ReqText permission 


types are valid types for this interface. 





Property PermissionsForAttr(IReqTypeKey As 
Long, lAttrkey As Long) As enumPermissions 

PermissionsForAttr | read-only Member of ReqPro40.Project Returns 
the current user's permissions for editing the 
AttrValues of the Attr type (data). 


String 0:1 


Property TracesFrom As Relationships read-only 
Member of ReqPro40.Requirement Returns a 
Relationships object representing all of the objects 
from which this requirement traces 


Sub MoveFirst() Member of ReqPro40. Views 
MoveFirst | Sets the current position in the collection to the first | Any 0:1 
item 


TracesFrom String 0:1 


Property StateName As String — read-only 
Member of ReqPro40.Relationship Returns the 
textual representation of the state of this 
Relationship 


StateName String 0:1 


Function GetDiscussionItem([Key As Long) As 
GetDiscussionItem | Object Member of ReqPro40.Project Returns the 
specified discussion or response 


String 0:1 


Function Add(sName As String, eViewType As 
enumViewTypes, sPrimaryQueryString As String, 
ePrimaryQueryStringFormat As 
enumQueryFormats, [sSecondaryQueryString As 
String], [eSecondaryQueryStringFormat As 
enumQueryFormats], [sPropertyString As String], 
[sDescription As String], [sVersionReason As 
String], [eViewVisibility As enumViewVisibility = 
1]) As View Member of ReqPro40.Views Adds 
the specified view to the collection 


Add String 0:1 


Property VersionRev As Long _ read-only 
VersionRev | Member of ReqPro40.Application Returns the 
version revision number 


String 0:1 


Function GetDiscussions() As Discussions 
GetDiscussions | Member of ReqPro40.Requirement Returns the 
Discussions object associated with this requirement 


String 0:1 





Function QueryFetch(eQueryBaseType As 


enumQueryBaseTypes, eQueryFormat As 


QueryFetch String 0:1 


enumQueryFormats, sQueryString As String, 
foOuervDef As Ohiectl) Member of 
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Template Slots 


ReqPro40.Project Executes the specified query = 


Function Display(eDisplayMode As 
enumDisplayModes, eDisplayType As 


Display | enumDisplayTypes) As Object Member of String 0:1 
ReqPro40.Requirement This method will display a 
requirement dialog of the mode and type received. 





Property Children As Relationships read-only 
Member of ReqPro40.Requirement Returns a 
collection of Relationship objects representing the 
children of this requirement 


Sub CloseServer() Member of : 
CleiseSciver ReqPro40.Application Reserved any se 


Property Item(vViewLookupValue, 
[eViewLookupType As enumViewLookups = 

Item | eViewLookup_Key]) As View _ read-only 
Default member of ReqPro40.Views Returns the 
specified View 


Children String 0:1 





0:1 


> 
i=} 
& 


Function GetRequirement(vReqLookupValue, 
[eReqLookupType As enumRequirementLookups = 
eReqLookup_Key], [eWeight As 
enumRequirementsWeights = 
eReqWeight_Medium], [eFlags As 
enumRequirementFlags]) As Requirement 

Member of ReqPro40.Project Returns the object 
for the specified requirement 


GetRequirement String 0:1 





Property DirectionName As String — read-only 
Member of ReqPro40.Relationships Returns the 

DirectionName | name of the direction of the relationship objects held 
by this collection (tracesto, tracesfrom, child, or 
parent) 


String 0:1 


Function ChangeLoggedInUser(vValue, 
[eUserLookup As enumUserLookups = 

ChangeLoggedinUser | eUserLookups_Key], [vValue2]) As Boolean 
Member of ReqPro40.Project Changes the user 
logged into the project. 


Boolean | 0:1 





Property IsNew As Boolean read-only Member 
IsNew | of ReqPro40.Requirement Indicates if the 
requirement is not new. 


Boolean | 0:1 


Property Suspect As Boolean Member of 
Suspect | ReqPro40.Relationships Sets all Relationship 
objects in the collection to suspect 


Boolean | 0:1 





Property IsServerOpen As Boolean _ read-only 
IsServerOpen | Member of ReqPro40.Application Determines 
whether the server is running 


NewRegqProCollection | Property NewReqProCollection As String 0:1 
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Boolean | 0:1 





Template Slots 


ReqProCollection read-only Member of 
ReqPro40.Project Returns anew 
ReqProCollection object. 


Property 
PermissionsForReqTraceability(IReqTypeKey As 
Long) As enumPermissions read-only Member 
of ReqPro40.Project Returns the current user's 
permissions for editing the t raceability of 
requirements of the requirement type (data). 


PermissionsForReqTraceability String 0:1 


Property RelationshipTypeName As String _ read- 
only Member of ReqPro40.Relationships 

Returns the name of the Relationship objects in this 
collection 


RelationshipTypeName String 0:1 





Property DestinationKey As Long _ read-only 
DestinationKey | Member of ReqPro40.Relationship Returns the 
key of the destination Requirement 


String 0:1 





Property 
SourceRequirementInfo(eRequirementInfoType As 
enumObjectInfoTypes) read-only Member of 
ReqPro40.Relationship Returns basic source 
Requirement info via direct SQL. Avoids loading 
the Requirement object. 


SourceRequirementInfo String 0:1 


Property DestinationRelKey As Long _ read-only 
Member of ReqPro40.Relationship Returns the 
key of the relationship in the project of the 
destination Requirement. 


Refresh | Sub RefreshQ) Member of ReqPro40.View Any 


Property Bookmark As String read-only 
Bookmark | Member of ReqPro40.Requirement Returns the String 0:1 
bookmark associated with this requirement (if any) 


DestinationRelKey String 0:1 





> 
pa 





Property 
PermissionsForListItemType(IReqTypeKey As 
Long, lAttrKey As Long, IListItemKey As Long) 

PermissionsForListItemType | As enumPermissions read-only Member of 
ReqPro40.Project Returns the current user's 
permissions for editing the ListItemValue of the 
ListItem type (data). 


String 0:1 





Function GetCurrentRelationship() As Relationship 
GetCurrentRelationship | Member of ReqPro40.Relationships Returns the 
Relationship object at the current cursor position 


String 0:1 





Property AreProjectsLocked As Boolean _ read- 
only Member of ReqPro40.Application 


AreProjectsLocked Boolean | 0:1 


Sub Save() Member of ReqPro40.Views Save 
all Views that have changed to the database 


DBProperties | Property DBProperties As Object read-only String 0:1 
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Save Any 0:1 


Template Slots 


Member of ReqPro40.Project Returns the 
properties for the project 


Function GetRequirements(vReqsLookup Value, 
[eReqsLookupType As enumRequirementsLookups 
= eReqsLookup_ReqTypeKey], [eWeight As 
enumRequirementsWeights = 

GetRequirements | eReqWeight_Medium], [eFlags As String 0:1 
enumRequirementFlags], [IPageSize As Long = 
1000], [IPages As Long = 2]) As Requirements 
Member of ReqPro40.Project Returns the 
requirements in the project 


Property IsDocBased As Boolean read-only 
IsDocBased | Member of ReqPro40.Requirement Returns Boolean | 0:1 
whether this requirement lives in a document 


Property IsProjectLocked(vProjLookupValue, 
[eProjLookuptype As enumProjectLookups]) As 
IsProjectLocked |Boolean read-only Member of Boolean | 0:1 


ReqPro40.Application Determines if a specific 
project has any outstanding locks. 





CLASS DOCUMENTS 
Template Slots 


Function ChangeLoggedInUser(v Value, 
[eUserLookup As enumUserLookups = 
ChangeLoggedInUser | eUserLookups_Key], [vValue2]) As Boolean Boolean |0:1 
Member of ReqPro40.Project Changes the 
user logged into the project. 


Sub Revert([bRevertAll As Boolean = False]) 
Revert | Member of ReqPro40.Views Restores objects | Boolean |0:1 
to their state when originally created 


Sub MovePrevious() Member of 
MovePrevious | ReqPro40.Views Set the current position in 
the collection to the previous item 





Property VersionMajor As Long _ read-only 
VersionMajor | Member of ReqPro40.Application Returns 
the major version number of the application 


Function 
GetRequirementsCount(vReqsLookupValue, 
[eReqsLookupType As 

GetRequirementsCount | enumRequirementsLookups = 
eReqsLookup_ReqTypeKey]) As Long 
Member of ReqPro40.Project Returns the 
count of records returned by a query. 


2. Property 
PemmessionsHerDocl ype PermissionsForDocType(IDocTypeKey As 
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Slot nan e 


CurrentKey 


EventRaiseEnabled 


Save 


PersonalCatalogltem 


DropObjects 


Count 


UserKey 


LockProject 


Action 


RefreshSecurity 


Template Slots 





Cardinality 


Long) As enumPermissions — read-only 
Member of ReqPro40.Project Returns the 
current user's permissions for editing the 
Documents of the Document type (data). 


Property CurrentKey As Long _ read-only 
Member of ReqPro40.Views Returns the key 
of the Requirement pointed to by 
CurrentPosition() 


i=) 
an 


Any 


Property EventRaiseEnabled As Boolean 
Member of ReqPro40.Application Returns or 
sets whether the server raises server events 


Sub Save() Member of ReqPro40.Views 
Save all Views that have changed to the Any 
database 


Boolean 





io) 
—_ 


a a 


jo) 
an 


Property 
PersonalCatalogItem(vCatLookup Value, 
[eCatLookupType As enumCatalogLookups = 
eCatLookup_Name]) As CatalogItem — read- String 
only Member of ReqPro40.Application 
Returns the specified catalog item from the 
Local catalog collection 


Sub DropObjects(eInterfaceID As 
enumInterfacelIdentifiers) Member of 
ReqPro40.Project Removes collections from 
the Project object 


io) 
an 


String 





Property Count As Long read-only Member 
of ReqPro40.Views Returns the number of Any 
View objects in the collection 


i=) 
an 





Property UserKey As Long _ read-only 
Member of ReqPro40.Project Returns the key 
of the current user 


i=) 
an 


String 


Function LockProject(vProjLookup Value, 
[eProjLookuptype As enumProjectLookups]) 
As String Member of ReqPro40.Application 
Locks a specific open project. 


String 





i=) 
— 


Event Action(eEventType As 
enumEventTypes, eObjectType As 
enumInterfaceldentifiers, sGUID As String, 
vEventData, eEventDataType As 
enumEventDataTypes, eEventSubType As 


> 
5 
= 
So 
pan 


enumEventSubTypes, sTimestamp As String) 
Member of ReqPro40.Application 


Sub RefreshSecurity() Member of 
ReqPro40.Project Retrieves current security 
information from the database 


String 
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Slot nan e 


SetExclusiveAccess 


VersionRev 


GetCurrentProjectUsers 


GetCurrentDocument 


OpenProjectProperties 


Item 


CompareVersionNumber 


AreProjectsLocked 


QueryValidate 


Add 


Template Slots 


Property SetExclusiveAccess As Boolean acai bt 
Member of ReqPro40.Project oolean |U: 


Property VersionRev As Long _ read-only 
Member of ReqPro40.Application Returns String 
the version revision number 





S 
= 


Function GetCurrentProjectUsers(sRQSPath As 
String) As Properties Member of 


ae 


String 
ReqPro40.Application 


Function GetCurrentDocument() As Document 
Member of ReqPro40.Documents Returns the 
Document object at the current position in the 
collection 


String 





unction 
OpenProjectProperties(vOpenProjOptionValue, 
[eOpenProjOptionType As 
enumOpenProjectOptions = 
eOpenProjOpt_RQSFile]) As Properties 
Member of ReqPro40.Application Opens a 
RequisitePro project and returns its properties 


ae 


String 


— 


S S S S S S S 
a 


Property Item(v ViewLookupValue, 
[eViewLookupType As enumViewLookups = 
eViewLookup_Key]) As View _ read-only 
Default member of ReqPro40.Views Returns 
the specified View 


> 
5 
= 
So 
= 


Function Compare VersionNumber(sNumber1 
As String, sNumber2 As String) Member of 
ReqPro40.Application Compares version 
numbers 


String 





Property AreProjectsLocked As Boolean 


read-only Member of ReqPro40.Application a 


Boolean 
Function Query Validate(eQueryBaseType As 
enumQueryBaseTypes, eQueryFormat As 
enumQueryFormats, sQueryString As String, 
[oQueryDef As Object]) As Long Member of 
ReqPro40.Project Checks the specified query 
for correct syntax 


String 


Function Add(sName As String, eViewType As 
enumViewTypes, sPrimaryQueryString As 
String, ePrimaryQueryStringFormat As 
enumQueryFormats, [sSecondaryQueryString 
As String], [eSecondaryQueryStringFormat As 
enumQueryFormats], [sPropertyString As 
String], [sDescription As String], 
[sVersionReason As String], [e View Visibility 
As enumViewVisibility = 1]) As View 
Member of ReaPro40.Views Adds the 


jo) 
an 


String 


i=) 
— 
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Template Slots 





Slot nan e 


ProjectLockCount 


CreateRequirement 


IsValidLock 


PermissionsForAttr 


CurrentPosition 


IsOpenedReadOnly 


Permissions ForListItemType 


CloseServer 


ValidPackage_ 


specified view to the collection ae ae 


Property 
ProjectLockCount(vProjLookup Value, 
[eProjLookuptype As enumProjectLookups]) 
As Long read-only Member of 
ReqPro40.Application Returns the number of 
ouststanding locks on a project object. 


String 0:1 


Function CreateRequirement(sName As String, 
sText As String, VReqTypeLookupValue, 
[eReqTypeLookupType As 
enumReqTypesLookups = 
eReqTypesLookups_Key], [sVersionLabel As 
String], [sVersionReason As String], 
[vParentReqLookup Value], 
[eParentReqLookupType As 
enumRequirementLookups = 
eReqLookup_Empty]) As Requirement 
Member of ReqPro40.Project 


Property IsValidLock(sGUID As String, 
vProjLookupValue, [eProjLookuptype As 
enumProjectLookups]) As Boolean read-only 
Member of ReqPro40.Application Returns 
whether the supplied GUID represents a valid 
lock. 


jo) 
an 


String 





jo) 
an 


String 


Property PermissionsForAttr(IReqTypeKey As 
Long, 1AttrKey As Long) As enumPermissions 
read-only Member of ReqPro40.Project 
Returns the current user's permissions for 
editing the AttrValues of the Attr type (data). 


String 





Property CurrentPosition As Long Member of 
ReqPro40.Views Returns or sets the current 
cursor position within the collection 


i=) 
an 


Property IsOpenedReadOnly As Boolean 
read-only Member of ReqPro40.Project 
Returns whether the current user has opend the 
project read only 


i=) 
an 


Boolean 





Property 
PermissionsForListItemType(IReqTyp eKey As 
Long, lAttrKey As Long, IListItemKey As 


jo) 
an 


Long) As enumPermissions — read-only 
Member of ReqPro40.Project Returns the 
current user's permissions for editing the 
ListItem Value of the ListItem type (data). 


Sub CloseServer() Member of n 
ReqPro40.Application Reserved ny 


Function ValidPackage (IKev As Long) As Boolean 


String 





jo) 
an 


i=] 
S 
_ 


0:1 
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Template Slots 





Boolean Member of ReqPro40.Project a; ee 


Property IsEOF As Boolean _ read-only 
IsEOF | Member of ReqPro40.Views Returns whether | Boolean | 0:1 
the end of the collection has been reached 







Property SecurityEnabled As Boolean 
SecurityEnabled | Member of ReqPro40.Project Returns or sets 
whether security is enabled for the project 


Boolean 


Property IsCurrentUserAdmin As Boolean 
read-only Member of ReqPro40.Project 
Returns whether the current user has 
administrative permissions 


Sub ExtendedHelp(sProduct As String, 
sSubTool As String, sItem As String, 

ExtendedHelp | sOperation As String, sQuery As String) 
Member of ReqPro40.Application Launches 
Rational Extended Help 


i=) 
an 


IsCurrentUserAdmin Boolean 


String 


Property IsProjectLocked(vProjLookupValue, 
[eProjLookuptype As enumProjectLookups]) 
IsProjectLocked | As Boolean read-only Member of 
ReqPro40.Application Determines if a 
specific project has any outstanding locks. 


jo) 
an 


S S S S 
a a 


Boolean 





Property AuthorID As Long _ read-only 


ao. Member of ReqPro40.Project 


String 0:1 
Property VersionDBSchema As Long _ read- 

VersionDBSchema| only Member of ReqPro40.Project Returns 
the database schema version number 


String 0:1 


Property 
PermissionsForReqType(IReqTypeKey As 
Long) As enumPermissions — read-only 
Member of ReqPro40.Project Returns the 
current user's permissions for editing the 
requirements of the requirement type (data). 


Property PWD As String Member of 
PWD | ReqPro40.Application Sets a default 


0 


ae 


PermissionsForReqType String 


String | 0:1 


password 


Property IsInDB(/Key As Long, eInterfaceID 
As enumInterfaceldentifiers, [sVersionNumber 

IsInDB | As String]) As Boolean read-only Member 
of ReqPro40.Project Returns whether the 
specified object is in the database 


Boolean |0:1 


Property DocSaveFormat As 
enumDocSaveFormat Member of 
ReqPro40.Project Returns the document save 
format 


GetCurrentUsers | Function GetCurrentUsers() As Properties String 0:1 
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0 


ae 


DocSaveFormat String 





Slot nan e 


PersonalCatalog 


IsLocked 


PermissionsForReqText 


GetRootPackage 


Refresh 


SequenceKey 


GetRequirements 


DBProperties 


LogRelationshipRevisions 


GetRequirement 


Template Slots 


Member of ReqPro40.Project ae ee 


Property PersonalCatalog As Catalog _ read- 

only Member of ReqPro40.Application String 0:1 
Returns the local Catalog object 

Property IsLocked As Boolean — read-only 

Member of ReqPro40.Project Returns a value | Boolean |0:1 
indicating whether or not the Project is locked. 

Property 

PermissionsForReqText(IReqTypeKey As Str 0:1 
Long) As enumPermissions — read-only ming . 
Member of ReqPro40.Project 

Function GetRootPackage([bLoadAllPackages 

As Boolean = False]) As RootPackage String | 0:1 
Member of ReqPro40.Project 


Sub Refresh() Member of ReqPro40. View 


Property SequenceKey As Long _ read-only 
Member of ReqPro40.Project Returns the 
sequence key for the project. The sequence key 
is an incrementing number assigned as a project 
is opened. 














String |0 


Function 
GetRequirements(vReqsLookup Value, 
[eReqsLookupType As 
enumRequirementsLookups = 
eReqsLookup_ReqTypeKey], [eWeight As 
enumRequirementsWeights = 
eReqWeight_Medium], [eFlags As 
enumRequirementFlags], [IPageSize As Long = 
1000], [IPages As Long = 2]) As Requirements 
Member of ReqPro40.Project Returns the 
requirements in the project 


String |0 


Property DBProperties As Object read-only 
Member of ReqPro40.Project Returns the 
properties for the project 


String |0 


Property LogRelationshipRevisions As Boolean 
Member of ReqPro40.Project Returns or sets 
whether relationships are logged in Revisions 





Boolean |0:1 


Function GetRequirement(vReqLookupValue, 
[eReqLookupType As 
enumRequirementLookups = 
eReqLookup_Key], [eWeight As 
enumRequirementsWeights = 
eReqWeight_Medium], [eFlags As 
enumRequirementFlags]) As Requirement 
Member of ReqPro40.Project Returns the 
object for the specified requirement 
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String 0 





Slot nan e 


IsServerOpen 


VersionMinor 


MoveFirst 


UserGroupKey 


IsBOF 


ROQSFilepath 


IsProjectOpen 


LockCount 


oCustomTypes 


PublishAction 


GetDiscussionItem 


PermissionsForReqName 


IsInKeyset 


Template Slots 





Cardinality 


Property IsServerOpen As Boolean read-only 
Member of ReqPro40. Application 
Determines whether the server is running 


Boolean 


Property VersionMinor As Long _ read-only 
Member of ReqPro40.Application Returns 
the minor version number of the application 


Sub MoveFirst() Member of ReqPro40. Views 
Sets the current position in the collection to the | Any 
first item 


i=) 


String 


=) 





i=) 


Property UserGroupKey As Long _ read-only 
Member of ReqPro40.Project Returns the 
group of the current user 


i=) 


String 


Property IsBOF As Boolean read-only 
Member of ReqPro40.Views Returns whether 
the current position represents the beginning of 


jo) 


Property RQSFilepath As String read-only 
Member of ReqPro40.Project Returns the 
pathname of the .rqs file 


io) 


String 


Property IsProjectOpen As Boolean read-only 
Member of ReqPro40.Project Returns 
whether the current user has the project open 


jo) 


Boolean 


Property LockCount As Long _ read-only 
Member of ReqPro40.Project Returns the 
number of outstanding locks against the 
Project. 





String 





Property CustomTypes As CustomTypes 
read-only Member of ReqPro40.Application 
Reserved for future use. 


Sub PublishAction(eEventType As 
enumEventTypes, eObjectType As 
enumInterfaceldentifiers, sGUID As String, 
vEventData, eEventDataType As 
enumEventDataTypes, eEventSubType As 
enumEventSubTypes) Member of 
ReqPro40.Application 


=) 


String 


String 


Function GetDiscussionItem(1Key As Long) As 
Object Member of ReqPro40.Project 
Returns the specified discussion or response 


i=) 


String 


Property 

PermissionsForReqName(lReqT ypeKey As 
Long) As enumPermissions — read-only 
Member of ReqPro40.Project 


0 


ae 


String 


Property IsInKeyset(IKey As Long) As 
Boolean read-only Member of 
ReaPro40.Views Returns whether the 
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j=) 
an 


Boolean 
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Template Slots 





Slot nan e 


AutoSuspect 


IsModified 


DocNameExists 


UnlockProject 


PermissionsForReqTraceability 


IsOpenedExclusive 


QueryFetch 


XMLVersion 


GetPackage 


Command 


NewRegqProCollection 


specified key is in the collection ae aes 


Property AutoSuspect As Boolean Member of 
ReqPro40.Project Returns or sets whether Boolean |0:1 
requirements are auto suspect 

Property IsModified As Boolean read-only 

Member of ReqPro40.Views Returns whether Boolean |0:1 
any of the Views in the collection have been : 
modified 


Function DocNameExists(sName As String) As Str 0:1 
Boolean Member of ReqPro40.Documents se : 


Sub UnlockProject(sGUID As String, 

vProjLookupValue, [eProjLookuptype As 
enumProjectLookups]) Member of String | 0:1 
ReqPro40.Application Removes a lock from a 

specific project. 

Property 

PermissionsForReqTraceability(IReqTypeKey 

As Long) As enumPermissions — read-only 

Member of ReqPro40.Project Returns the String 0:1 
current user's permissions for editing the 

traceability of requirements of the requirement 

type (data). 


Property IsOpenedExclusive As Boolean 

read-only Member of ReqPro40.Project Hesiean: tet 
Returns whether the current user has opened the : 
project exclusively 

Function QueryFetch(eQueryBaseType As 
enumQueryBaseTypes, eQueryFormat As 

enumQueryFormats, sQueryString As String, String 0:1 
[oQueryDef As Object]) Member of : 
ReqPro40.Project Executes the specified 

query 


Property XMLVersion As Long _ read-only 
Member of ReqPro40.Project 


Function GetPackage(IKey As Long, [eWeight 
As enumPackageWeights = 
ePackageWeight_Empty]) As Package 
Member of ReqPro40.Project 











String | 0:1 


String 0:1 


Function Command([vOne], [vT wo], [vThree]) 
Member of ReqPro40.Project Generic 
Interface for providing additional functionality. 


String 0:1 





Property NewReqProCollection As 


ReqProCollection read-only Member of 


String 0:1 


ReqPro40.Project Returns a new 
ReqProCollection object. 
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Slot nan e 


MoveNext 


Version 


ItemCurrent 


MoveLast 


CLASS DOCUMENT 


Sub MoveNext() Member of 
ReqPro40.Views Set the current position in Any 0:1 
the collection to the next item 


Property Version As String read-only 
Member of ReqPro40.Application Returns 
the version of the application 


Property ItemCurrent As Document read-only 
Member of ReqPro40.Views Returns the 
Document associated with the current item 


> 
i=] 
mS 
2 
a 


Sub MoveLast() Member of ReqPro40.Views 
Sets the current position in the collection to the | Any 0:1 
last item 





Slot nan e 


FileFlags 


VersionDBSchema 


CompareVersionNumber 


ProjectLockCount 


IsBOF 


RefreshSecurity 


oCustomTypes 


IsEOF 


UserKey 


Template Slots 


Documentation Cardinality 
Property FileFlags As String read-only 
Member of ReqPro40.Document Returns the String 
file system flags 
Property VersionDBSchema As Long _ read- 
only Member of ReqPro40.Project Returns String 
the database schema version number 


Function CompareVersionNumber(sNumber1! As 
String, sNumber2 As String) Member of Stri 
ReqPro40.Application Compares version ming 


numbers 


Property ProjectLockCount(vProjLookupValue, 
[eProjLookuptype As enumProjectLookups]) As 

Long read-only Member of String 
ReqPro40.Application Returns the number of 


ouststanding locks on a project object. 


Property IsBOF As Boolean _ read-only 
Member of ReqPro40.Views Returns whether |An 
the current position represents the beginning of 


Sub RefreshSecurity() Member of 
ReqPro40.Project Retrieves current security String 
information from the database 


Property CustomTypes As CustomTypes _ read- 
only Member of ReqPro40.Application String 
Reserved for future use. 


Property IsEOF As Boolean _ read-only 
Member of ReqPro40.Views Returns whether /|Boolean | 0:1 
the end of the collection has been reached 


Propertv UserKev As Long read-only 
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Slot nan e 


CurrentPosition 


ChangeLoggedInUser 


VersionMinor 


IsInDB 


RQSFilepath 


GetCurrentProjectUsers 


PersonalCatalog 


OpenProjectProperties 


DropObjects 


Item 


IsOpenedReadOnly 


Template Slots 


Member of ReqPro40.Project Returns the key 

of the current user 

Property CurrentPosition As Long Member of 
ReqPro40.Views Returns or sets the current Any O:1 
cursor position within the collection 





Function ChangeLoggedInUser(v Value, 
[eUserLookup As enumUserLookups = 


eUserLookups_Key], [vValue2]) As Boolean Boolean 
Member of ReqPro40.Project Changes the user 
logged into the project. 


Property VersionMinor As Long _ read-only 
Member of ReqPro40.Application Returns the 
minor version number of the application 


Property IsInDB(IKey As Long, eInterfaceID As 
enumInterfaceldentifiers, [sVersionNumber As 
String]) As Boolean read-only Member of 
ReqPro40.Project Returns whether the 
specified object is in the database 


i=) 


String 





io) 


Boolean 


Property RQSFilepath As String read-only 
Member of ReqPro40.Project Returns the 
pathname of the .rqs file 


So 


String 


Function GetCurrentProjectUsers(sRQSPath As 
String) As Properties Member of 
ReqPro40.Application 


String 





Property PersonalCatalog As Catalog read-only 
Member of ReqPro40.Application Returns the 
local Catalog object 


String 


unction 
OpenProjectProperties(vOpenProjOptionValue, 
[eOpenProjOptionType As 
enumOpenProjectOptions = 
eOpenProjOpt_RQSFile]) As Properties 
Member of ReqPro40.Application Opens a 
RequisitePro project and returns its properties 


Sub DropObjects(eInterfaceID As 
enumInterfacelIdentifiers) Member of 
ReqPro40.Project Removes collections from 
the Project object 


So 


String 


So 


String 


i=) 





Property Item(v ViewLookupValue, 
[eViewLookupType As enumViewLookups = 
eViewLookup_Key]) As View _ read-only Any 
Default member of ReqPro40.Views Returns 

the specified View 


i=) 


a a a a a a a a a 





Property IsOpenedReadOnly As Boolean _ read- 
only Member of ReqPro40.Project Returns 


Boolean | 0:1 
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Slot nan e 


PermissionsForReqType 


Count 


PermissionsForDocType 


PermissionsForReqName 


DocNameExists 


Command 


ExtendedHelp 


IsProjectLocked 


CreateRequirement 


AuthorID 


Template Slots 


whether the current user has opend the project 
read only 





Property PermissionsForReqType(IReqTypeKey 

As Long) As enumPermissions — read-only 

Member of ReqPro40.Project Returns the String 0:1 
current user's permissions for editing the 


requirements of the requirement type (data). 


Property Count As Long read-only Member 
of ReqPro40.Views Returns the number of Any 
View objects in the collection 


me 





Property PermissionsForDocType(IDocTypeKey 
As Long) As enumPermissions read-only 
Member of ReqPro40.Project Returns the 
current user's permissions for editing the 
Documents of the Document type (data). 


String O:1 


Property 
PermissionsForReqName(IReqTypeKey As 
Long) As enumPermissions — read-only 
Member of ReqPro40.Project 


Function DocNameExists(sName As String) As Stri 0:1 
Boolean Member of ReqPro40.Documents ming ; 


Function Command([vOne], [vT wo], [vThree]) 
Member of ReqPro40.Project Generic Interface 
for providing additional functionality. 


Sub ExtendedHelp(sProduct As String, sSubTool 
As String, sItem As String, sOperation As String, 
sQuery As String) Member of 
ReqPro40.Application Launches Rational 
Extended Help 


String O:1 





String 


String 


Property IsProjectLocked(vProjLookup Value, 
[eProjLookuptype As enumProjectLookups]) As 
Boolean read-only Member of 
ReqPro40.Application Determines if a specific 


io) 
an 


S S S 2 S S 2 
a a a 


Boolean 


project has any outstanding locks. 


Function CreateRequirement(sName As String, 
sText As String, VReqTypeLookupValue, 
[eReqTypeLookupType As 
enumReqTypesLookups = 
eReqTypesLookups_Key], [sVersionLabel As 
String], [sVersionReason As String], 
[vParentReqLookup Value], 
[eParentReqLookupType As 
enumRequirementLookups = 
eReqLookup_Empty]) As Requirement 
Member of ReqPro40.Project 


Propvertv AuthorID As Long _ read-only String 0:1 
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String 





Template Slots 





Member of ReqPro40.Project a Ea 


Function GetCurrentUsers() As Properties : . 
GetCurrentUsers Member of ReqPro40.Project String 0:1 
Property IsServerOpen As Boolean _ read-only 
IsServerOpen | Member of ReqPro40.Application Determines |Boolean | 0:1 
whether the server is running 
Property PermissionsForReqText(IReqTypeKey 
PermissionsForReqText | As Long) As enumPermissions — read-only String 0:1 
Member of ReqPro40.Project 


Function GetDiscussionItem(1Key As Long) As 
GetDiscussionItem | Object Member of ReqPro40.Project Returns 
the specified discussion or response 


Property Name_ As String Member of : . 
Nene ReqPro40.Document Sune sais 


Property IsOpenedExclusive As Boolean _ read- 
only Member of ReqPro40.Project Returns 
whether the current user has opened the project 
exclusively 


Sub UnlockProject(sGUID As String, 
vProjLookupValue, [eProjLookuptype As 

UnlockProject | enumProjectLookups]) Member of 
ReqPro40.Application Removes a lock from a 
specific project. 





String 0:1 





IsOpenedExclusive Boolean | 0:1 


String 


Property DocSaveFormat As 
enumDocSaveFormat Member of 
ReqPro40.Project Returns the document save 
format 


DocSaveFormat String 





Function Add(sName As String, eViewType As 
enumViewTypes, sPrimaryQueryString As 
String, ePrimaryQueryStringFormat As 
enumQueryFormats, [sSecondaryQueryString As 
String], [eSecondaryQueryStringFormat As 

Add | enumQueryFormats], [sPropertyString As 
String], [sDescription As String], 
[sVersionReason As String], [eViewVisibility As 
enumViewVisibility = 1]) As View Member of 
ReqPro40.Views Adds the specified view to 
the collection 


String 





Property Version As String read-only 
Version | Member of ReqPro40.Application Returns the 
version of the application 


String 





Property FileExtension As String read-only 
FileExtension | Member of ReqPro40.Document Returns the 
file extension for the document 


MoveLast | Sub MoveLast() Member of ReqPro40.Views | Any 
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String 





0:1 


S S S S S S S 
a a a a a 


Slot nan e 


VersionMajor 


IsLocked 


UserGroupKey 


NewReqProCollection 


FileDateTime 


IsProjectOpen 


PersonalCatalogltem 


QueryValidate 


Refresh 


CurrentKey 


AutoSuspect 


SequenceKey 


Template Slots 


Sets the current position in the collection to the 
last item 





Property VersionMajor As Long _ read-only 


Member of ReqPro40.Application Returns the | String 
major version number of the application 





Property IsLocked As Boolean _ read-only 
Member of ReqPro40.Project Returns a value 
indicating whether or not the Project is locked. 


io) 


Boolean 1 


Property UserGroupKey As Long _ read-only 
Member of ReqPro40.Project Returns the 
group of the current user 





io) 
an 


String 


Property NewReqProCollection As 
ReqProCollection read-only Member of 
ReqPro40.Project Returns a new 
ReqProCollection object. 


=) 
an 


String 


Property FileDateTime As String read-only 
Member of ReqPro40.Document Returns the 
file system modification time 


String 





Property IsProjectOpen As Boolean read-only 
Member of ReqPro40.Project Returns whether 
the current user has the project open 


Boolean 1 





Property 
PersonalCatalogItem(vCatLookup Value, 
[eCatLookupType As enumCatalogLookups = 
eCatLookup_Name]) As CatalogItem _ read- 
only Member of ReqPro40.Application 
Returns the specified catalog item from the 
Local catalog collection 


io) 
an 


S S S S S S S S 
pa 


String 


io) 
—_ 





Function Query Validate(eQueryBaseType As 
enumQueryBaseTypes, eQueryFormat As 
enumQueryFormats, sQueryString As String, 
[oQueryDef As Object]) As Long Member of 
ReqPro40.Project Checks the specified query 
for correct syntax 


Sub Refresh() Member of ReqPro40.View 
Property CurrentKey As Long _ read-only 
Member of ReqPro40.Views Returns the key . 

: 2 Any 0:1 
of the Requirement pointed to by 
CurrentPosition() 
Property AutoSuspect As Boolean Member of 
ReqPro40.Project Returns or sets whether Boolean | 0:1 
requirements are auto suspect 
Property SequenceKey As Long _ read-only 
Member of ReqPro40.Project Returns the String O:1 
sequence key for the project. The sequence key 


an 


String 
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Template Slots 





Slot nan e 


PermissionsForAttr 


SecurityEnabled 


ItemCurrent 


IsInKeyset 


GetRequirement 


LockProject 


EventRaiseEnabled 


FullOfflinePath 


SetExclusiveAccess 


ValidPackage_ 


Permissions ForListItemType 


is an incrementing number assigned as a project 
is opened. 


Property PermissionsForAttr(IReqTypeKey As 

Long, lAttrkey As Long) As enumPermissions 

read-only Member of ReqPro40.Project String 0:1 
Returns the current user's permissions for editing 

the AttrValues of the Attr type (data). 


Property SecurityEnabled As Boolean Member 
of ReqPro40.Project Returns or sets whether 
security is enabled for the project 


Boolean 


i=) 


a a a a a a a 


Property ItemCurrent As Document read-only 
Member of ReqPro40.Views Returns the Any 
Document associated with the current item 


i=) 


Property IsInKeyset(IKey As Long) As Boolean 
read-only Member of ReqPro40.Views 
Returns whether the specified key is in the 
collection 


jo) 


Boolean 


Function GetRequirement(vReqLookupValue, 
[eReqLookupType As 
enumRequirementLookups = 
eReqLookup_Key], [eWeight As 
enumRequirementsWeights = 
eReqWeight_Medium], [eFlags As 
enumRequirementFlags]) As Requirement 
Member of ReqPro40.Project Returns the 
object for the specified requirement 


io) 


String 





Function LockProject(vProjLookup Value, 
[eProjLookuptype As enumProjectLookups]) As 
String Member of ReqPro40.Application 
Locks a specific open project. 


String 





Property EventRaiseEnabled As Boolean 
Member of ReqPro40.Application Returns or 
sets whether the server raises server events 


io) 


Boolean 





Property FullOfflinePath As String read-only 
Member of ReqPro40.Document Returns the 
full path of the offline document 


Property SetExclusiveAccess As Boolean Bool 
Member of ReqPro40.Project ooren 
Function ValidPackage_(IKey As Long) As Bool 
Boolean Member of ReqPro40.Project ee 


Property 
PermissionsForListItemType(IReqTypeKey As 
Long, lAttrKey As Long, IListItemKey As Long) 


jo) 


String 








0:1 


0:1 


0 


ae 


String 


As enumPermissions read-only Member of 
ReqPro40.Project Returns the current user's 
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Template Slots 





permissions for editing the ListItemValue of the 
ListItem type (data). 


Function GetRo otPackage([bLoadAllPackages 
GetRootPackage | As Boolean = False]) As RootPackage Member | String 
of ReqPro40.Project 







S 
ra 


Property IsModified As Boolean read-only 
Member of ReqPro40.Views Returns whether 
any of the Views in the collection have been 
modified 


IsModified Boolean 


Function 
GetRequirementsCount(vReqsLookupValue, 
[eReqsLookupType As 

GetRequirementsCount | enumRequirementsLookups = 
eReqsLookup_ReqTypeKey]) As Long 
Member of ReqPro40.Project Returns the 
count of records returned by a query. 


Sub MoveNext() Member of ReqPro40. Views 
MoveNext | Set the current position in the collection to the Any 
next item 


Sub Revert([bRevertAll As Boolean = False]) 
Revert | Member of ReqPro40.Views Restores objects 
to their state when originally created 


String 


S 2 2 S S S S 
a a a a a a 


Boolean 


Property LogRelationshipRevisions As Boolean 
LogRelationshipRevisions | Member of ReqPro40.Project Returns or sets 
whether relationships are logged in Revisions 


Boolean 


Function GetCurrentDocument() As Document 
Member of ReqPro40.Documents Returns the 
Document object at the current position in the 





GetCurrentDocument String 





collection 
Property PWD As String Member of , : 
xe ReqPro40.Application Sets a default password Sirng o 
anita Property ItemLabel As Boolean Member of Boolean |0:1 


ReqPro40.Document 


Function GetRequirements(vReqsLookup Value, 
[eReqsLookupType As 
enumRequirementsLookups = 
eReqsLookup_ReqTypeKey], [eWeight As 


enumRequirementsWeights = 


GetRequirements String 0:1 


eReqWeight_Medium], [eFlags As 
enumRequirementFlags], [IPageSize As Long = 
1000], [[Pages As Long = 2]) As Requirements 
Member of ReqPro40.Project Returns the 
requirements in the project 


; Property IsValidLock(sGUID As String, ' 
vanah Gch vProjLookupValue, [eProjLookuptype As mn 
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0:1 


Template Slots 





Slot nan e 


enumProjectLookups]) As Boolean read-only 
Member of ReqPro40.Application Returns 
whether the supplied GUID represents a valid 
lock. 





Sub CloseServer() Member of . 
Closcsomer ReqPro40.Application Reserved 


QueryFetch 


VersionRev 


IsCurrentUserAdmin 


PublishAction 


XMLVersion 


MovePrevious 


PermissionsForReqTraceability 


MoveFirst 


Action 


Function QueryFetch(eQueryBaseType As 
enumQueryBaseTypes, eQueryFormat As 
enumQueryFormats, sQueryString As String, 
[oQueryDef As Object]) Member of 
ReqPro40.Project Executes the specified query 


Property VersionRev As Long _ read-only 
Member of ReqPro40.Application Returns the 
version revision number 


Property IsCurrentUserAdmin As Boolean 
read-only Member of ReqPro40.Project 
Returns whether the current user has 
administrative permissions 


Sub PublishAction(eEventType As 
enumEventTypes, eObjectType As 
enumInterfaceldentifiers, sGUID As String, 
vEventData, eEventDataType As 
enumEventDataTypes, eEventSubType As 
enumEventSubTypes) Member of 
ReqPro40.Application 


Property XMLVersion As Long _ read-only Stri 0:1 
Member of ReqPro40.Project ming : 


Sub MovePrevious() Member of 
ReqPro40.Views Set the current position in the 
collection to the previous item 





Property 
PermissionsForReqTraceability(IReqTypeKey 
As Long) As enumPermissions — read-only 
Member of ReqPro40.Project Returns the 
current user's permissions for editing the 
traceability of requirements of the requirement 
type (data). 


Sub MoveFirst() Member of ReqPro40. Views 
Sets the current position in the collection to the 
first item 


Event Action(eEventType As enumEventTypes, 
eObjectType As enumInterfaceldentifiers, 
sGUID As String, vEventData, eEventDataType 
As enumEventDataTypes, eEventSubType As 
enumEventSubTypes, sTimestamp As String) 
Member of ReqPro40.Application 
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Slot nan e 


Template Slots 








Property LockCount As Long _ read-only 
LockCount | Member of ReqPro40.Project Returns the String 0:1 
number of outstanding locks against the Project. 


DBProperties 


Save 


DocTypeKey 


AreProjectsLocked 


GetPackage 





Property DBProperties As Object read-only 
Member of ReqPro40.Project Returns the String 
properties for the project 


Sub Save() Member of ReqPro40. Views 
Save all Views that have changed to the uate (AY _| 


Property DocTypeKey As Long _ read-only 
Member of ReqPro40.Document Returns the | String 
key for the document type of the document 


Property AreProjectsLocked As Boolean _ read- Bool 0-1 
only Member of ReqPro40.Application eeeeen 


Function GetPackage(IKey As Long, [eWeight 

As enumPackageWeights = : 
ePackageWeight_Empty]) As Package Sanne as 
Member of ReqPro40.Project 
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APPENDIX D. CLASS HIERARCHY FOR 
SEATOOLS_ONTOLOGY PROJECT 


Following the same pattern used to present the RequisitePro ontology, in this 
appendix we present the SEATools ontology captured in Protégé-2000. We start by 
illustrating the class hierarchy tree for the SEATools ontology. This hierarchy consists of 
a selected set of classes (a subset of all SEATools classes) that we judged to be most 
useful for establishing our interoperability ontology. Following the hierarchy all of these 
classes are then shown in detail. These classes include: DataFlowComponent, Edge, 
Vertex, PSDLTime, DataTypeObj, DataTypes, TypeOp, TimerOp, ExceptionGuard, 
OutputGuard, VertexProperties, EdgeProperties, PSDLBuilderConstraints, PSDLBuilder, 
Token, CompilePrototype, TranslatePrototype, SchedulePrototype, ExecutePrototype, 
CAPSAdaFileList, CAPSMainWindow and CAPSResultList. 


223 


o SEATools 
« DataFlowComponent 


= Edge 
» Vertex 
» PSDLTime 


« DataTypeObj 

« DataTypes 

« TypeOp 

« TimerOp 

« ExceptionGuard 

= OutputGuard 

= VertexProperties 

= EdgeProperties 

« PsdlBuilderConstants 
« Psd|Builder 

« Token 

« CompilerPrototype 

« TranslatePrototype 

« SchedulePrototype 

« ExecutePrototype 

= CapsAdaFileList 

«= CapsMainWindow 

« CapsResultList 
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Project: SEATools _Ontology: 
Class DataFlowComponent 


Template Slots 


String |0:1 


Slot name | Documentat on 

delete:void | public method 
getLabelX Offset: int| public method 

setld:void | public method 
setLabelOffset:void | public method 


= 
= 
Ss 

o 


n 
A 
=] 
5 
ge 
2 
pa 


toString:String | public method : 


setLabelXOffset:void | public method 
setLabelY Offset: void | public method 
setLabel:void | public method 
setMetX Offset:void | public method 


ss 

5 
o]s 
ra 


moveTo.void | public method 


getMetlFont:Font| public method 
setMet:void | public method 
getLabel:string | public method 
getMetX Offset: int | public method Integer |0:1 


getMetY Offset:int | public method Integer |0:1 


Integer 
getY-int| public method Integer 
getld:int| public method =| Integer 

getMet:PSDLTime | public method String 


String |0:1 


Template Slots 


getLabelY Offset:int| public method 


n 
o 
a 
5 
ga 
S 
oo 


n n 

= = 

a. f : ; 
5 

gq ga 

So 

a 


setMetYOffset:void | public method 


getX:int| public method 
CLASS EDGE 


initialControlPoints. get: String PI String [Ok 
initialControlPoints. set:String String Ost 
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Template Slots 


stateStream.set:boolean Boolean OE 
selectedHandleIndex. get: int Integer JOP 
selectedHandleIndex.set:int Integer JOE | 
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CLASS VERTEX 
Template Slots 


specReqmts.set: Vector ‘multiple Floats |Float |0:1 | 

specReqmts. get: Vector Float a i, 

inEdges Vector. get:vector —— 
triggerStreamsList.set: Vector ‘multiple Floats |Float |0:1 | 
outEdgesVector. get: Vector | String Jor fe 
defaultOutputGuards: OutputGuards | String for fs 
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Template Slots 


getExceptionGuardList: String public = | String JO:1 | 
finishWithin.set:PSDLYime | String Jor fe 
extractOtherPropertiesList: String public =| String Jt | 
exceptionGuard: ExceptionGuard | String fot | 
terminator.set:boolean | Boolean 0:1 | 
terminator.get:boolean | Boolean Ot | 
outEdgesVector.set: Vector | String fOr | 
inEdgesVector.set:vector | {String Jor | 
exceptionGuardList: String | String Jot fe 
exceptionGuard. get: ExceptionGuard | String fOr | 
outputGuardList.set:String | String fod 
getOtherPropertiesList: Vector public =| String 01 | 
228 


Template Slots 


defaultOutputGuards. get: OutputGuards | String Jor fe 
exceptionGuardList. get: String | String Jot | 
periodReqmts. get: Vector ‘multiple Floats |Float |0:1 | 
criticalStatus.set:int | |Integer JOP 
exceptionGuardList. set: String | String Jot | 
finishWithinReqmts.set: Vector ‘multiple Floats |Float jt | 
criticalStatus.get:int | |Integer JOP 
informalDesc. set:String | String fOr | 
netWorkLabel. set: String | String Jor | 
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Template Slots 


outputGuardList. get: String | String fOr fe 
exceptionGuard. set: ExceptionGuard | String for f 
defaultOutputGuards. set: OutputGuards String Ot | 
triggerStreams List. get: Ve ctor ‘multiple Floats |Float |0:1 0 | 
finishWithinReqmts. get: Vector ‘multiple Floats |Float |0:1 0 | 
exceptionList.set: String | String fOr | 
ifCondition. set: String | {String fOr fe 
getOutputGuardList: String public = String Od | 
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Template Slots 


triggerStreamsList: Vector ‘multiple Floats |Float = |0:1 = | 
periodReqmts.set: Vector ‘multiple Floats |Float = |0:1 | 
netWorkLabel. get: String | {string Jor fe 
finishWithinReqmts: Vector ‘multiple Floats |Float |0:1 | 


CLASS PSDLTIME 
Template Slots 


time Value. set: int Integer |O:1 | 
timeInSecond.set:double Ol 
setTimeUnits: void | public method String [01 | 
microsec: int| public Integer [0:1 

time Value. get:int Integer |O:1 | 

ms: int| public Integer [0:1 | 

time Value. int Integer |O:1 | 

hours:int| public Integer [0:1 

sec:int| public Integer |O:1 | 

| 


timeInSecond: double 
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CLASS DATATYPEOBJ 
Template Slots 


Slot name | Docume itation Default 
genDecl.set:String 
ops.get: Vector | multiple Floats 
ops.set: Vector | multiple Floats 
name: String 
genDecl:String | public 
keyDecs.set:String 
keyDecs.get:String 
toSring: String | public 
typelmpl: String | public 
name. get: String 
existOp: boolean | public 
typeName: String | public 
keyDesc: String 
updateTypeOp:void 
findTypeOp:TypeOp | public 
name. set: String 


CLASS DATATYPES 


genDecl.get:String 


impl.set:String 


impl. get: String 


Template Slots 


Slot name | Docur entation Cirdinality | Default 
existType: boolean | public Boolean |O:1 | 


findType:DataTypeObj | public 
UpdateTypes:void | public 





addType:void | public 
CLASS TYPEOP 
Template Slots 


Slot name | Documentation Cirdinality | Default 


opName:Strin g | public 0:1 
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CLASS TIMEROP 


= 
oO 
5 

sc 
= 
5 
- 
© 
n 
2 
3 
-*- 
n 


Slot name | Docui ientation 


Type Default 


reqTrace:String | public 
reqTrace.set:String 
guardCondition. get:String 
timerOperation. get: string 
guardCondition: String | public 
guardCondition. set: String 
timerOperation. set:string 


timerOperation: String | public 


reqTrace. get: String 


CLASS EXCEPTIONGUARD 

CLASS OUTPUTGUARD 

CLASS VERTEXPROPERTI ES 

Template Slots 
resetTimingPanelCom ponents: void public method = String [0:1 | 
keywordsButton:JButton declaration [Boolean 01 | 

returnTopestParent: Vertex publicmethod =| String 01 | 
metReqByButton:JButton declaration [Boolean [0:1 | 
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Template Slots 


triggerReqByButton:JButton | declaration 
fwUnitsCombo:JComboBox | multiple,string,int,floats 


vertex: Vertex 


isTimingTypeChanged: boolean | public 


n 
i 
a. 
5 
ic) 


multiple, string, int, 
floats 


tempVertex: Vertex | declaration 


formalDescButton:JButton | declaration 
periodUnitsCombo:JComboBox | multiple,string,int,floats 


metUnitsCombo:JComboBox 


multiple, 
string, int,floats 


informalDescButton:JButton | declaration Boolean |0:1 | 


languageCombo:JComboBox 


> 
3 
< 


targetVertex: Vertex | declaration 


periodReqByButton:JButton | declaration 
actionPerformed.:void | public method 
operatorCombo:JComboBox a ee Any 
ifConditionButton:JButton | declaration 
outputGuardsButton:JButton | declaration 
updatePeriod:void | public method 
timerOpsButton:JButton | declaration 
resetVertexType:void | public method 
isVertexTypeChanged: boolean | public 
CLASS EDGEPROPERTIES 


Template Slots 


Slot name Default 
firstEnter:boolean 
ay 
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Template Slots 


Slot name Cardinality | Default 


—_— 


latencyField:JTextField 0:1 
CLASS PSDLBUILDERCONSTANTS 





Template Slots 


usr Yepsr rT 

on|paie meg Jor [ 

AXIOMS | public 
STRING LITERAL | public 
IMPLEMENTATION public 
CHAR LIT | public 
OUTPUT | public 

TRUE | public 
IDENTIFIER | public 
TRIGGERED | public 
DEFAULT | public 
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Template Slots 


CC 
DESCRIPTION | public 0:1 
KEYWORDS | public 0:1 
GENERIC| public 0:1 
GRAPH | public 0:1 
PLUS | public 0:1 
tokenImage | public 0:1 
REM | public 0:1 
AMPERCENT | public 0:1 
ABS | public 0:1 
EXCEPTIONS | public 0:1 
IF | public 0:1 


GREATER OR EQUAL an ig 


SPECIFICATION | public 0:1 


EOF | public 0:1 

SEC| public 0:1 

TYPE | public 0:1 
NETWORKMAPPING | public O:1 
INPUT | public 0:1 

ID DIGIT | public 0:1 
INITIALLY | public 0:1 

FACTOR | public 0:1 

LESS OR EQUAL TO | public 0:1 
EQUALS | public 0:1 

DASH | public 0:1 

TEXT | public 0:1 

OPERATOR | public 0:1 
LITTERORDIGIT | public 0:1 
MINUS | public 0:1 

END | public 0:1 

MS | public 0:1 

STATES | public 0:1 
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Template Slots 


oD pais Imes or [|] 
EXCEPTION | public 
INTEGER LITERAL | public 
PERIOD | public 

EDGE | public 

STAR STAR | public 
DIVIDE EQUALS | public 
HOURS | public 


CLASS PSDLBUILDER 


Template Slots 


initial expression list: Vector publicmethod [String |O1 = | 
initial expression suffix1 publicmethod [String JO1 = | 
build exception guard map: Exc publicmethod [String |O1 = | 
check output guards: void publicmethod [String |O1 = | 
id:String | public method sting jot | 

7 
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Template Slots 


Finnie imac fon |S 
oR|pie——iimeaer oY 


build t 
i es public method String 
a 


operator spec:void ple method | method 
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Template Slots 


MN piie [ines for |S 
check exception guards:void [public method [String |O1 | 
GRarHpaic lines for «|S 

239 


Template Slots 


us|pubie nese for 

Lerren|pie—_|ineaer fon |S 

OPERATOR mic ince fol 
240 


Template Slots 


build output guard map: output publicmethod [String JO1 | 


CLASS TOKEN 


Template Slots 


S .OT NAME |DOCUMINTATION | TYPE | CARDINALITY |DEFAULT 
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Template Slots 


S .OT NAME |DOCUMINTATION | TYPE | CARDINALITY |DEFAULT 





CLASS COMPILERPROTOTYPE 
CLASS TRANSLATEPROTO TYPE 
CLASS SCHEDULEPROTOTY PE 
CLASS EXECUTEPROTOTY PE 
CLASS CAPSADAFILELIST 


Template Slots 


setProtoVersion:void | public method 


setProtoName:void \public method 
valueChanged: void | public method 


CLASS CAPSMAINWINDOW 





Template Slots 


schedResult: CapsResultList 


tial initialize:void (public St 
initialize cei ring 


protoHome. st} 
transList.set: CapsResultList fe} —____ 
compilList.set: CapsResultList tring JOE 
scheList.get: CapsResultList String JOD 
242 


Template Slots 


scheList.set: CapsResultList String OE 
transResult:CapsResultList ‘transResult:CapsResultList |String [01 | 
transList.get: CapsResultList String Ot 
compiResult: CapsResultList ‘compiResult:CapsResultList |String [0:1 | 
compilList. get: CapsResultList String JOE 
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CLASS CAPSRESULTLIST 
Template Slots 


setResultItem:void | public method 
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APPENDIX E. CLASS HIERARCHY FOR 
HIGH_LEVEL_ONTOLOGY PROJECT 


Appendix E presents the High-Level Software Development Tool Ontology 
(high_level_ontology) project generated by Protégé-2000. This ontology is given as a 
class hierarchy of the different classes of the high level ontology accounted for in 


developing the interoperability ontology. Note here that there are currently no slots 


defined for this high level ontology. 
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o Tool 
o Actor 
= Team 
= Stakeholders 
= Developers 
= Designers 
= Architects 
o Activity 
= Communication 
= Management 
« Organization 


« Sorting 
« Filtering 
«= Synchronization 
» Archiving 
= Maintenance 
= Creation 
= Coding 


« Modification 
« Verification 
o Artifacts 
» Document 
« Reports 
« Statistics 
« Database 
«= Feedback 
« Efficiency 
= Links_Dependencies_Traceability 


= Security 

» Child_Parent 
» Risk 

= Safety 


« Project_Component 
= Requirements 


= Model 

» Use_Case 

«Library 

« Prototype 
= Testing 


Project: test_ontology 
Class Tool 
Class Actor 


Class Team 
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Class Stakeholders 
Class Designers 

Class Developers 
Class Architects 

Class Activity 

Class Communication 
Class Management 
Class Organization 


Class Maintenance 
Class Creation 


Class Modification 
Class Verification 
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